文档Experience Cloud KCS

Cloud Manager代码扫描失败和覆盖行为问题

最近更新： 2026年7月6日

当Adobe Experience Manager as a Cloud Service (AEMaaCS) Cloud Manager代码质量关键或重要指标不符合部署要求时，代码扫描会失败。 出现此问题的原因是Cloud Manager强制实施代码质量审核，以阻止关键问题的部署，并根据管道配置有条件地允许覆盖重要问题。 该问题会影响部署进度、管道执行，以及到目标环境的代码提升。 要解决此问题，请修复违规、验证覆盖并重新运行管道。

描述 description

环境

Adobe Experience Manager as a Cloud Service (AEMaaCS)

问题/症状

  • 在代码质量步骤期间，管道因FAIL_CRITICAL_METRICS而失败。
  • 管道在重要问题上暂停，并在存在以前的覆盖时显示​ 已覆盖 ​警告。
  • 当CSV报表包含“严重”或“主要”调查结果时，Cloud Manager UI显示零“严重”问题。
  • 覆盖选项在管道UI中不可用。

根本原因

出现此问题的原因是Cloud Manager实施了由“关键”、“重要”和“信息”量度组成的三层代码质量模型。 严重问题始终阻止部署，不支持覆盖。 仅当管道类型和配置允许时，重要问题才会暂停部署并支持覆盖。 UI和CSV结果之间会存在差异，因为CSV包含原始扫描结果，而UI显示量度派生的结果。 当故障为严重或管道类型不支持覆盖时，覆盖选项不可用。

解决方法 resolution

按照以下步骤识别故障类别并成功解决代码扫描问题。

  1. 通过查看失败管道执行中的代码质量步骤，确定管道失败是否包含关键或重要问题。
  2. 通过下载CSV结果并查看规则ID、严重性和文件引用，验证Cloud Manager UI和CSV报表之间的差异。
  3. 通过更正CSV报告中标识的代码违规来解决严重问题，因为严重问题不支持覆盖。
  4. 通过查看重要问题部分并验证当前管道类型允许覆盖功能来确定管道是否支持覆盖。
  5. 确认在需要覆盖审批时，分配的角色包括部署经理、项目经理或业务负责人权限。
  6. 通过为受影响的规则应用相应的@SuppressWarnings注释并重新运行管道来隐藏有效的误报。
  7. 通过查看配置的管道行为并验证它是否与业务要求匹配来验证重要量度行为设置。
  8. 由于生成失败会阻止代码质量覆盖可用性，因此请在排除覆盖行为故障之前验证生成步骤是否成功完成。
  9. 验证解决方案，方法是确认管道通过了代码质量步骤或通过了批准的覆盖路径，严重问题返回零，并且CSV和UI结果符合预期值。

何时上报

  • 应用所有已识别的代码修复后，关键问题依然存在。
  • 验证管道类型和分配的角色后，覆盖选项仍然不可用。
  • CSV报表包含与预期行为不匹配的规则ID或严重性分类。
  • 验证后，UI和CSV结果继续显示不一致的严重性信息。

相关阅读

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