文件Experience Cloud KCS

由於Adobe Commerce中的Valkey連線埠設定不正確，部署失敗

最後更新： 2026年7月31日

當Valkey過時快取設定在.magento.env.yaml檔案中使用不正確的連線埠時，雲端基礎結構上的Adobe Commerce會發生部署失敗。 若要解決此問題，請更新Valkey連線埠並成功重新部署。

說明 description

環境

  • 雲端基礎結構上的產品： Adobe Commerce
  • 版本： 2.4.8
  • 部署環境：整合

問題/症狀

  • 在.magento.env.yaml中套用過時快取設定時，部署失敗。
  • 部署記錄顯示下列錯誤： 純文字1連線至Redis獨立tcp://localhost:6370在1次失敗後失敗。 上一個錯誤： (111)連線被拒。
  • Adobe Commerce無法連線至已設定的Valkey快取後端。
  • Valkey連線設定參照了設定中不正確的連線埠。
  • 在快取後端設定期間，部署驗證失敗。

解決方法 resolution

請依照下列步驟解決問題：

  1. 在.magento.env.yaml中推送Stale Cache設定之前，請執行以下命令以取得Valkey關係的詳細資料：

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. 記下為現有Valkey服務傳回的連線埠值。

  3. 在.magento.env.yaml檔案中找出所有對Valkey連線埠的參照，並將每個出現的連線埠6370更新為上一個步驟中識別的正確連線埠值。

  4. 檢閱backend_options區段，並將任何連線埠26370的參考更新至正確的Valkey連線埠（如果存在）。

  5. 儲存更新的.magento.env.yaml檔案並認可變更。

  6. 使用正確的設定重新部署Adobe Commerce應用程式。

  7. 確認部署已成功完成，並確認部署記錄中沒有Valkey連線錯誤。

注意：請確認所有參考Valkey的組態檔（包括.magento.app.yaml和services.yaml）都使用相同的連線埠組態。

相關閱讀

recommendation-more-help
experience-cloud-kcs-help-kbarticles