解决在自定义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 错误。 - 如果目标环境在部署期间未完全处于活动状态,也可能会发生索引失败。
原因
失败是由于CommonJS和ES模块依赖项在自定义UI测试配置中不兼容。 此外,如果目标环境未处于活动状态,则部署可能会失败。
解决方法 resolution
请按照以下步骤解决问题:
-
查看您的自定义UI测试依赖项,特别是与WebdriverIO相关的依赖项(如
@wdio/logger和wdio-html-nice-reporter)。 -
更新import语句以实现ESM兼容性:
- 从CommonJS文件(如
launcher.js和comparisonstrategy.js)中删除所有require('@wdio/logger')导入。 - 用简单的日志记录语句替换这些导入,或者根据需要使用动态
import()。
- 从CommonJS文件(如
-
调整报告器配置:
- 如果使用仅ESM报告程序(如
wdio-html-nice-reporter),请确保在配置文件(如wdio.conf.commons.js)中使用import语法而不是require()加载它们。 - 如果依赖项集要求重构配置文件使其与ESM兼容,或者从reporters阵列中删除仅用于ESM的记录器,以运行Cloud Manager。
- 如果使用仅ESM报告程序(如
-
在运行部署管道之前,请确保目标环境完全处于活动状态,以避免索引失败。 如果环境之前已休眠,请激活它并重新运行管道。
-
重新运行部署管道并监视错误。
-
验证自定义UI测试步骤是否成功完成,以及部署是否继续进行且没有出现模块兼容性错误。
recommendation-more-help
experience-cloud-kcs-help-kbarticles