解決在自訂UI測試期間,由於ESM/CommonJS相容性而導致AEM Cloud Manager部署失敗的問題

本文提供在Adobe Experience Manager (AEM) Cloud Manager中的自訂UI測試步驟期間,解決部署管道故障的步驟,這些故障是由ES模組(ESM)和CommonJS相依性之間的相容性問題所導致。

說明 description

環境

Adobe Experience Manager as a Cloud Service (所有版本)

問題/症狀

  • 部署管道在Cloud Manager中的自訂UI測試步驟期間失敗。
  • 錯誤記錄檔顯示如下訊息: ERR_REQUIRE_ESM:必須使用匯入來載入ES模組: @wdio/logger。
  • 在組態檔中使用require()載入僅ESM的記者(例如wdio-html-nice-reporter)時,會產生其他錯誤,導致類似的​ ERR_REQUIRE_ESM ​錯誤。
  • 如果目標環境在部署期間未完全啟用,也可能會發生索引失敗。

原因

失敗的原因是在自訂UI測試設定中CommonJS和ES模組相依性之間的不相容性。 此外,如果目標環境未啟用,部署可能會失敗。

解決方法 resolution

請依照下列步驟解決問題:

  1. 檢閱您的自訂UI測試相依性,尤其是與WebdriverIO相關的專案(例如@wdio/logger和wdio-html-nice-reporter)。

  2. 更新ESM相容性的匯入陳述式:

    • 從CommonJS檔案(例如launcher.js和comparisonstrategy.js)移除所有require('@wdio/logger')匯入。
    • 以簡單的記錄陳述式取代這些匯入,或在必要時使用動態import()。
  3. 調整報告器組態:

    • 若使用僅限ESM的記錄器(例如wdio-html-nice-reporter),請確定已在組態檔(例如wdio.conf.commons.js)中使用import語法而非require()載入。
    • 如果您的相依性集需要的話,請將組態檔重構為ESM相容,或從Cloud Manager執行的reporters陣列移除僅限ESM的記錄器。
  4. 在執行部署管道之前,請確保目標環境完全處於活動狀態,以避免索引失敗。 如果環境先前是休眠的,請啟動它並重新執行管道。

  5. 重新執行部署管道並監視錯誤。

  6. 確認自訂UI測試步驟成功完成,且部署進行時沒有發生模組相容性錯誤。

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