文档 Experience Cloud KCS

当预览Dispatcher未准备就绪时，Cloud Manager管道停止并失败

最近更新： 2026年8月6日

本文介绍如何解决在启动状态下持续存在数小时，然后在预览Dispatcher未及时就绪时失败的AEM as a Cloud Service部署管道。

描述 description

环境

Adobe Experience Manager (AEM) as a Cloud Service
Cloud Manager部署管道使用带有托管重写映射的Dispatcher配置

问题/症状

部署管道在失败之前长时间保持启动或预热状态。
在与content/dam/rewrites/redirects相关的日志中会看到调度程序启动和准备情况检查失败。
Cloud Manager会在长时间延迟后显示一般部署失败消息。

The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.

构建和代码质量步骤已成功完成，但部署之后无法正常进行。
即使在上次运行中成功部署了相同分支或代码，也可能发生此问题。
当项目使用托管重写映射并预览Dispatcher启动延迟时，更有可能发生这种情况。

复制条件

尝试使用Cloud Manager将代码（甚至以前成功的代码）部署到开发环境。
预览Dispatcher或相关的预览服务在预期时间范围内不会正常运行。
管道在长时间等待后失败，或者成功完成，但运行时间异常长。

原因

部署管道挂起，并最终失败，因为预览Dispatcher容器未达到就绪状态，从而导致Cloud Manager等待超时。更新Dispatcher YAML配置以将等待标志设置为false可允许预览Dispatcher启动而不会阻止管道。

解决方法 resolution

要修复由预览Dispatcher启动阻止在托管重写映射上导致管道延迟和失败，请执行以下步骤：

确认所有预览服务（包括Dispatcher）均已正确配置，并且可以正常启动。查看Cloud Manager日志，了解与预览Dispatcher相关的任何准备工作或运行状况检查失败。
编辑Dispatcher配置YAML文件，如rewrite-maps.yaml或managed-rewrite-maps.yaml。查看文件中可以阻止启动的映射条目，并确保所有映射条目的wait标志均设置为false。例如：

maps:
        - name: redirects-301.map
        path: /content/dam/rewrites/redirects-301.txt
        ttl: 300
        wait: false
        - name: redirects-302.map
        path: /content/dam/rewrites/redirects-302.txt
        ttl: 300
        wait: false

保存更改并将其提交到存储库，然后在Cloud Manager中重新运行管道。
监视管道执行，以确认预览Dispatcher和相关服务及时达到健康状态，而不是保持长时间启动或预热状态。
成功部署后，验证是否已按预期部署Dispatcher代码。
如果管道仍然需要比预期更长的时间或失败，请查看Dispatcher并预览服务日志，以了解其他准备情况、运行状况检查或启动问题。

recommendation-more-help

experience-cloud-kcs-help-kbarticles