无法在云存储库上访问Adobe Commerce：部署时出现403 Forbidden或404 Not Found错误

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

环境

云基础架构上的Adobe Commerce版本2.2.x、2.3.x和2.4.x

问题/症状

在云基础架构上部署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 Forbidden

或

无法下载“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 支持请求
。
如果帐户所有者可以登录，请验证
图像ID
与正确的电子邮件地址关联。如果关联不正确，请使用
打开市场支持票证 联系我们，
或电子邮件
Commerce Marketplace支持
请求更新。

步骤2：更新编辑器身份验证配置

将身份验证密钥添加到env:COMPOSER_AUTH变量，或验证是否已配置正确的值。确保在项目级别、环境级别以及auth.json文件（如果存在）中的值一致。有关详细信息，请参阅准备现有系统。

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

如果您使用env:COMPOSER_AUTH变量，Adobe建议从项目中删除auth.json以避免凭据冲突。如果保留文件，请确保它包含正确的身份验证密钥。

登录到拥有Adobe Commerce on cloud infrastructure 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中监控部署状态，并确认包下载已成功完成。