無法存取雲端存放庫上的Adobe Commerce：部署時出現403禁止或404找不到

Last update: Fri Jun 12 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

若要解決Adobe Commerce部署錯誤，例如 403 Forbidden 或404 Not Found，請取得有效的授權金鑰，並確定已在env:COMPOSER_AUTH變數和auth.json檔案中正確指定這些金鑰。

注意：僅擁有有效的授權金鑰無法保證存取該代碼。如果發生開立商業發票問題或您的合約已過期，您將無法存取程式碼及提交支援票證。

說明 description

環境

雲端基礎結構版本2.2.x、2.3.x和2.4.x上的Adobe Commerce

問題/症狀

在雲端基礎結構上部署Adobe Commerce時，您可能會遇到錯誤，指出無法存取存放庫URL，導致部署失敗。在專案UI的部署錯誤記錄中，會顯示類似以下內容的錯誤訊息：

無法存取'https://repo.magento.com/archives/magento/magento-cloud-configuration/magento-magento-cloud-configuration-x.x.x.x.zip' URL： HTTP/1.1 403禁止存取

或

無法下載'https://repo.magento.com/archives/magento/module-customer-segment/magento-module-customer-segment-x.x.x.x-patchY.zip'檔案（HTTP/1.1 404找不到）

（按一下專案UI中的失敗圖示以檢視記錄。）

原因

這些錯誤的主要原因是無效或指定的授權金鑰不正確。原因可能是：

使用從共用帳戶產生的金鑰
因付款問題而撤銷授權
設定的金鑰已從帳戶中刪除
在env:COMPOSER_AUTH和auth.json中使用不同的驗證金鑰，這可能會導致權益衝突及封裝下載失敗
Adobe Commerce權益已移至其他帳戶(MAGE ID)，同時環境會繼續使用使用使用之前/已終止帳戶下產生的撰寫器驗證金鑰。

注意：如果您發現這是因開立發票或合約失效問題所造成，請連絡您的Adobe客戶團隊以取得解決此問題的指引。授權重新啟動後，您的支援和部署權益將會還原。

解決方法 resolution

在您開始之前：請確定您使用的是目前授權的 Adobe Commerce帳戶下產生的Composer驗證金鑰。在之前或已終止帳戶下產生的金鑰將無法運作。

步驟1：產生新的驗證金鑰

如果您使用在共用帳戶下建立的金鑰，請聯絡Adobe Commerce授權擁有者以產生新的驗證金鑰。如果您的授權先前因付款問題而被撤銷，且已續約，則您必須
產生新的驗證金鑰.
如果帳戶擁有者無法登入
Adobe Commerce Marketplace，
提交
透過Adobe Experience League 支援請求
。
如果帳戶擁有者可以登入，請確認
影像識別碼
與正確的電子郵件地址相關聯。如果關聯不正確，請使用
開啟市集支援票證 連絡我們，
或電子郵件
Commerce Marketplace支援
要求更新。

步驟2：更新撰寫器驗證設定

將驗證金鑰新增至env:COMPOSER_AUTH變數，或驗證是否已設定正確的值。確保專案層級、環境層級和auth.json檔案（如果存在）中的值一致。如需詳細資訊，請參閱準備現有的系統。

步驟3：更新或移除`auth.json`

如果您使用env:COMPOSER_AUTH變數，Adobe建議從專案移除auth.json以避免認證衝突。如果您保留檔案，請確定它包含正確的驗證金鑰。

登入在雲端基礎結構上擁有您的Adobe Commerce SSH金鑰的電腦，然後登入您的專案：

magento-cloud login

建立分支以更新組態（例如，auth）：

magento-cloud environment:branch auth

從專案根目錄，在文字編輯器中開啟auth.json並視需要更新：

{
  "http-basic": {
    "repo.magento.com": {
      "username": "<public_key>",
      "password": "<private_key>"
    }
  }
}

步驟4：認可變更並部署

儲存變更，然後提交並推送至存放庫：

git add -A
git commit -m "<message>"
git push origin master

在專案UI中監視部署狀態，並確認套件下載已成功完成。