Maven多线程构建触发OverConstrainedVersionException异常问题

我之前碰到过类似的问题，虽然你用的Maven核心和插件都标注了线程安全，但Maven 3.2.x版本的多线程构建机制在依赖版本解析环节存在共享状态竞争的隐性问题——单个插件线程安全不代表Maven核心的依赖解析上下文在多线程下能完全隔离，这就导致了间歇性的OverConstrainedVersionException，而单线程串行解析时不会出现这种交叉干扰。

下面给你几个递进的解决方案，你可以根据实际情况尝试：

1. 优先升级Maven核心版本 #

Maven 3.2.3是2014年的老版本了，后续的3.3.x及以上版本对多线程构建的并发安全性做了大幅优化，尤其是依赖解析的线程隔离逻辑。建议直接升级到Maven 3.8.x系列（LTS长期支持版），这是从根源上解决这类并发问题最稳妥的方式。

2. 调整多线程构建策略（临时方案） #

如果暂时没法升级Maven，可以试试调整多线程的执行方式：

• 用-T 1C代替固定的-T 4，让Maven根据CPU核心数自动分配线程，能减少线程冲突的概率
• 拆分构建流程，先单线程处理依赖解析阶段，再用多线程执行后续步骤：

  mvn clean dependency:resolve -DskipTests && mvn install -T 4 -DskipTests
  

3. 显式锁定所有依赖版本 #

在pom.xml的<dependencyManagement>节点里明确锁定所有依赖的版本，避免Maven在多线程下动态解析版本时出现约束冲突的累积：

<dependencyManagement>
  <dependencies>
    <!-- 示例：锁定Gson版本 -->
    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
    </dependency>
    <!-- 把项目中所有依赖都在这里锁定版本 -->
  </dependencies>
</dependencyManagement>

4. 升级插件到最新稳定版 #

虽然你当前用的插件版本标注了线程安全，但后续版本可能修复了并发场景下的隐性bug：

• 将maven-dependency-plugin升级到3.6.0
• 将maven-assembly-plugin升级到3.4.2
  修改后的插件配置如下：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-dependency-plugin</artifactId>
      <version>3.6.0</version>
    </plugin>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-assembly-plugin</artifactId>
      <version>3.4.2</version>
    </plugin>
  </plugins>
</build>

验证方法 #

修改后可以重复执行多次多线程构建来确认问题是否解决：

# 连续执行10次多线程构建，看是否还会抛出异常
for i in {1..10}; do mvn clean install -T 4; done

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