Windows环境AEM云服务SPA项目Maven构建maven-enforcer-plugin报错求解

根因分析 #

这个报错的核心原因是Windows与类Unix系统的换行符差异：

• AEM Cloud项目预设的default_renders.any、default_virtualhosts.any属于规范要求的不可变文件，maven-enforcer插件会基于文件原始LF换行符计算校验和进行校验
• Windows系统git默认开启core.autocrlf=true配置，拉取代码时会自动将远端的LF换行符转换为本地的CRLF格式，导致两个文件的实际校验和与预设值不匹配，触发校验失败。这也是相同项目可以在Mac设备正常构建的原因。

解决方案 #

1. 首选方案（符合开发规范，无副作用） #

仅调整当前项目的git换行符配置，还原文件原始格式即可：

1. 进入项目根目录，执行命令关闭当前项目的自动换行符转换：
   git config core.autocrlf false
2. 还原被错误修改的两个dispatcher配置文件：
   git checkout -- src/conf.dispatcher.d/renders/default_renders.any src/conf.dispatcher.d/virtualhosts/default_virtualhosts.any
3. 重新执行原构建命令即可正常构建。

2. 全局优化方案（避免后续同类问题） #

如果需要长期开发跨平台项目，可以修改git全局配置，拉取代码时不自动转换换行符，提交时自动转换为LF：
git config --global core.autocrlf input

3. 临时调试方案（仅本地使用，禁止提交相关修改） #

如果仅需要本地调试前端代码不需要校验dispatcher配置，可以在构建时添加参数跳过enforcer插件校验：
mvn clean install -Denforcer.skip=true

现有临时方案说明 #

你当前使用的注释dispatcher模块、手动上传ui.apps包的方案仅能满足本地author实例的基础调试需求，缺失了dispatcher配置的校验和打包逻辑，无法验证dispatcher规则，也不满足云环境的部署要求，不建议长期使用。

内容的提问来源于stack exchange，提问作者Hikaru