文件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會顯示0個「嚴重」問題。
  • 管道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