解决在自定义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

请按照以下步骤解决问题:

  1. 查看您的自定义UI测试依赖项,特别是与WebdriverIO相关的依赖项(如@wdio/logger和wdio-html-nice-reporter)。

  2. 更新import语句以实现ESM兼容性:

    • 从CommonJS文件(如launcher.js和comparisonstrategy.js)中删除所有require('@wdio/logger')导入。
    • 用简单的日志记录语句替换这些导入,或者根据需要使用动态import()。
  3. 调整报告器配置:

    • 如果使用仅ESM报告程序(如wdio-html-nice-reporter),请确保在配置文件(如wdio.conf.commons.js)中使用import语法而不是require()加载它们。
    • 如果依赖项集要求重构配置文件使其与ESM兼容,或者从reporters阵列中删除仅用于ESM的记录器,以运行Cloud Manager。
  4. 在运行部署管道之前,请确保目标环境完全处于活动状态,以避免索引失败。 如果环境之前已休眠,请激活它并重新运行管道。

  5. 重新运行部署管道并监视错误。

  6. 验证自定义UI测试步骤是否成功完成,以及部署是否继续进行且没有出现模块兼容性错误。

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