文档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