解決在自訂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
請依照下列步驟解決問題:
-
檢閱您的自訂UI測試相依性,尤其是與WebdriverIO相關的專案(例如
@wdio/logger和wdio-html-nice-reporter)。 -
更新ESM相容性的匯入陳述式:
- 從CommonJS檔案(例如
launcher.js和comparisonstrategy.js)移除所有require('@wdio/logger')匯入。 - 以簡單的記錄陳述式取代這些匯入,或在必要時使用動態
import()。
- 從CommonJS檔案(例如
-
調整報告器組態:
- 若使用僅限ESM的記錄器(例如
wdio-html-nice-reporter),請確定已在組態檔(例如wdio.conf.commons.js)中使用import語法而非require()載入。 - 如果您的相依性集需要的話,請將組態檔重構為ESM相容,或從Cloud Manager執行的reporters陣列移除僅限ESM的記錄器。
- 若使用僅限ESM的記錄器(例如
-
在執行部署管道之前,請確保目標環境完全處於活動狀態,以避免索引失敗。 如果環境先前是休眠的,請啟動它並重新執行管道。
-
重新執行部署管道並監視錯誤。
-
確認自訂UI測試步驟成功完成,且部署進行時沒有發生模組相容性錯誤。
recommendation-more-help
experience-cloud-kcs-help-kbarticles