Maven写入至resolver-status.properties致构建失败的解决办法

• 系统：MacOS
• Maven版本：3.8.7
• Java版本：Eclipse Temurin 11.0.17
• 问题现象：构建大型Maven项目时，resolver-status.properties文件被写入无效的\u0000（空字符），示例内容如下：

.m2/repository/some-project/1.0-SNAPSHOT/resolver-status.properties:3:\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000=
.m2/repository/some-project/1.0-SNAPSHOT/resolver-status.properties:4:maven-metadata-willhaben-ne\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000=
.m2/repository/some-project/1.0-SNAPSHOT/resolver-status.properties:8:maven-metadata-shibboleth-\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000=

• 后续构建失败，报错信息：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  6.281 s
[INFO] Finished at: 2023-01-17T09:19:29+01:00
[INFO] ------------------------------------------------------------------------
[ERROR] Malformed \uxxxx encoding.
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.

• 单线程、多线程构建均会触发该错误

1. 清理损坏的缓存文件 #

直接删除包含无效字符的resolver-status.properties文件，或清理整个项目对应的快照仓库目录：

rm -rf ~/.m2/repository/some-project/1.0-SNAPSHOT/

清理后重新执行构建，Maven会重新生成正常的状态文件。

2. 升级Maven版本 #

Maven 3.8.x版本存在仓库元数据处理相关的已知Bug，空字符写入问题在3.9.0及以上版本中已被修复。升级步骤：

• 下载对应版本的Maven本地包
• 更新系统环境变量指向新版本
• 验证版本：

mvn -v

3. 禁用快照仓库的状态缓存 #

在~/.m2/settings.xml中添加配置，阻止Maven生成resolver-status.properties文件：

<profiles>
  <profile>
    <id>disable-resolver-status</id>
    <properties>
      <maven.resolver.status.enabled>false</maven.resolver.status.enabled>
    </properties>
  </profile>
</profiles>
<activeProfiles>
  <activeProfile>disable-resolver-status</activeProfile>
</activeProfiles>

4. 检查远程仓库元数据 #

部分场景下，远程仓库的maven-metadata.xml文件本身损坏，导致Maven解析时写入无效字符。可手动检查对应远程仓库的元数据文件，或切换至稳定的镜像仓库。

内容的提问来源于stack exchange，提问作者Harold L. Brown