Ubuntu环境下IntelliJ IDEA运行Spring Boot项目依赖未入类路径问题

看起来你在Ubuntu环境下遇到了Maven依赖无法正常加载的问题，而Windows上能正常运行，这种情况通常是本地仓库依赖损坏、IDE缓存或者Maven配置的问题，下面给你几个针对性的解决步骤：

1. 清理并重新下载Maven依赖 #

Windows上正常说明你的pom.xml配置没问题，大概率是Ubuntu本地Maven仓库里的依赖包损坏或者没下载完整。你可以：

• 找到本地Maven仓库路径（默认是~/.m2/repository），删除和项目相关的依赖文件夹，比如org/springframework/boot、org/mybatis/spring-boot、com/alibaba这些；
• 然后在IntelliJ的Maven面板里执行clean和install，或者直接在项目根目录打开终端运行：

  mvn clean install -U
  

  这里的-U参数会强制Maven更新快照依赖，确保下载最新的完整包。

2. 刷新IntelliJ的Maven缓存与IDE缓存 #

有时候IDE会缓存旧的依赖状态，导致识别不到新下载的包：

• 先在右侧Maven面板点击顶部的刷新按钮（圆圈箭头图标），或者右键项目 → Maven → Reimport，让IDE重新读取Maven配置；
• 如果还是不行，试试清除IDE的全局缓存：点击File → Invalidate Caches / Restart...，选择Invalidate and Restart，重启后IDE会重新构建缓存，很多奇怪的依赖问题都能解决。

3. 检查IntelliJ的Maven配置 #

确认IDE使用的Maven环境是正确的：

• 打开File → Settings → Build, Execution, Deployment → Build Tools → Maven；
• 检查Maven home directory是否指向正确的Maven安装路径（可以用系统自带的或者IDE内置的），Local repository路径是否和你刚才清理的一致，避免IDE用了其他位置的仓库。

4. 优化Maven镜像配置（可选） #

如果是因为默认Maven中央仓库下载慢导致依赖不完整，可以修改~/.m2/settings.xml（没有的话新建一个），添加国内镜像源：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <mirrorOf>central</mirrorOf>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>

修改后再执行mvn clean install -U重新下载依赖。

5. 检查运行配置 #

你的项目打包方式是war，确认IntelliJ的Run Configuration里：

• 正确选择了Spring Boot的主类；
• 运行配置的类路径包含了所有依赖模块，没有遗漏。

先从前面两步开始试，一般就能解决问题了！

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