Spring Boot中Gradle需引入何种依赖以使用MultiValueMap？

遇到这个问题大概率是依赖缺失、IDE缓存或者类路径配置出了问题，我给你梳理几个最有效的排查步骤：

1. 先确认依赖配置是否正确 #

MultiValueMap 属于 spring-core 包，首先要确保你的项目依赖里已经正确引入了这个包，并且版本和你使用的Spring框架一致：

Maven 配置示例 #

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>你的Spring版本号（比如5.3.20）</version>
    <!-- 如果仅在测试中使用，可添加test scope；如果主代码也用到，就去掉 -->
    <!-- <scope>test</scope> -->
</dependency>

Gradle 配置示例 #

// 测试环境依赖
testImplementation 'org.springframework:spring-core:你的Spring版本号'
// 如果主代码也需要，用implementation替代testImplementation

如果你已经引入了 spring-web 包，它会自动依赖 spring-core，这时候可以检查 spring-web 的依赖是否正常加载，没有版本冲突。

2. 验证导入语句的正确性 #

确保你导入的是正确的包，不要和其他同名类混淆：

// 正确的导入
import org.springframework.util.MultiValueMap;

注意不要误导入 org.springframework.http.MultiValueMap（这是前者的子接口，虽然也能用，但错误提示明确指向util包的类，所以优先确保util包的类能被访问）。

3. 清理IDEA缓存并重启 #

Windows下IDEA的缓存偶尔会抽风，导致明明有依赖却找不到类：

1. 点击顶部菜单栏的 File -> Invalidate Caches...
2. 在弹出的窗口中选择 Invalidate and Restart，等待IDEA重启后，执行 Build -> Rebuild Project 重新构建整个项目。

4. 检查模块依赖与SDK配置 #

• 确认项目使用的JDK版本符合Spring要求：比如Spring 5需要JDK 8及以上，Spring 6需要JDK 17及以上。可以通过 File -> Project Structure -> Project 查看SDK版本。
• 检查模块依赖：进入 File -> Project Structure -> Modules -> 选中你的模块 -> Dependencies 标签，确保 spring-core 或包含它的jar包已经在依赖列表中，且没有红色感叹号（如果有，点击右侧的刷新按钮重新加载）。

5. 排查依赖冲突 #

如果项目中存在多个版本的Spring依赖，可能会导致类加载异常：

• Maven用户可以在终端执行 mvn dependency:tree，查看依赖树中是否有多个版本的 spring-core，找到冲突的版本并通过 <exclusions> 标签排除。
• Gradle用户执行 gradle dependencies 命令查看依赖树，同样排除冲突的旧版本。

6. 检查测试类的类路径 #

有时候测试类的类路径和主代码不一致：

1. 右键你的JUnit测试类 -> Run -> Edit Configurations
2. 在弹出的窗口中切换到 Classpath 标签，确认 spring-core 的jar包已经包含在类路径中，如果没有，手动添加进去。

按照这个顺序排查，基本能解决大部分这类问题。

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