Maven依赖冲突：java.lang.NoSuchMethodError问题求助

这个问题我之前帮同事排查过，典型的Spring版本依赖冲突导致的运行时错误，咱们一步步拆解解决：

问题根源 #

你遇到的NoSuchMethodError: org.springframework.util.MultiValueMap.addAll(...)，本质是运行时JVM加载到的MultiValueMap类是旧版本的Spring核心类（比如Spring 4.x），而Spring Boot 2.0.2.RELEASE依赖的是Spring Framework 5.0.6.RELEASE，这个方法在Spring 5.x中才存在。

你的内部项目依赖了spring-context和spring-orm，大概率是这些内部项目硬编码了较低的Spring版本，作为传递依赖覆盖了Spring Boot Parent管理的版本——虽然Maven的依赖调解机制理论上会优先用声明在POM里的版本，但如果内部项目的依赖路径更短或者被强制指定，就会出现冲突。

解决方案 #

1. 先定位冲突的依赖 #

首先用Maven命令生成依赖树，找到哪个依赖引入了旧版本的Spring：

mvn dependency:tree

在输出里搜索spring-core、spring-context、spring-orm，看有没有版本低于5.0.6.RELEASE的条目，重点看来自你内部项目的传递依赖。

2. 强制统一Spring版本（推荐） #

利用Maven的<dependencyManagement>块，强制指定所有Spring相关依赖的版本，继承Spring Boot Parent的版本，避免传递依赖搞事情：

<dependencyManagement>
    <dependencies>
        <!-- 强制统一Spring核心组件版本 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>${spring.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

这里的${spring.version}会自动继承Spring Boot Parent里的5.0.6.RELEASE，不用手动写死版本号。

3. 排除内部项目的传递依赖 #

如果不想全局统一，也可以在引入内部项目时，直接排除掉它带的Spring依赖：

<dependency>
    <groupId>your.internal.group</groupId>
    <artifactId>your-internal-project</artifactId>
    <version>x.y.z</version>
    <!-- 排除内部项目传递的旧Spring依赖 -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
        </exclusion>
    </exclusions>
</dependency>

这样项目就会用Spring Boot Parent管理的Spring版本，而不是内部项目带的旧版本。

4. 额外的清理步骤 #

有时候Maven本地仓库会缓存旧版本的jar，执行以下命令强制清理并重新构建：

mvn clean install -U

额外建议 #

你的POM里引入了log4j 1.2.16，Spring Boot默认使用Logback作为日志框架，虽然两者兼容，但长期来看建议换成Spring Boot官方支持的spring-boot-starter-log4j2，避免潜在的日志框架冲突。

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