Mac环境下Spring Boot容器化遇Jar未找到及依赖缺失问题求助

我来帮你一步步排查和解决这个问题——毕竟手动运行Spring Boot可执行Jar时遇到的找不到Jar或依赖缺失，大多是构建或运行环节的小疏漏。

1. 先确认Jar文件的存在与路径是否正确 #

首先别着急排查依赖，先确保你要运行的Jar真的在指定位置：

• 执行Maven构建后，可执行Jar默认会生成在项目根目录的target文件夹下，先通过命令确认它的存在：
  • Linux/macOS：ls target/
  • Windows：dir target\
• 运行Jar时，要保证你的命令路径正确：
  • 如果在项目根目录，直接用java -jar target/your-app-version.jar（替换成你的实际Jar文件名）
  • 如果不在根目录，要么切换到Jar所在目录，要么使用绝对路径，比如java -jar /home/user/projects/your-app/target/your-app-version.jar
• 注意文件名的大小写和版本号，别打错了！比如把my-app-1.0.0.jar写成myapp-1.0.jar就会报找不到Jar。

2. 验证你的Jar是否是真正的Spring Boot可执行"胖Jar" #

你说Jar里包含所有依赖，但得确认它是Spring Boot标准的可执行Jar结构：

• 执行jar tf your-app-version.jar（替换成你的Jar名），查看输出内容：
  • 必须包含BOOT-INF/lib目录（里面应该有所有依赖的Jar包）
  • 必须包含BOOT-INF/classes目录（你的项目编译后的class文件）
  • 查看META-INF/MANIFEST.MF文件，里面需要有这两个关键配置：

    Main-Class: org.springframework.boot.loader.JarLauncher
    Start-Class: com.yourpackage.YourApplicationMainClass
    

    前者是Spring Boot的启动加载器，后者是你项目的主类全限定名，缺一个都无法正常启动。

3. 检查Maven Profile的构建配置是否正确 #

Spring Boot的可执行Jar必须靠spring-boot-maven-plugin来构建，哪怕你用了自定义Profile，也得确保这个插件被正确配置：

• 打开你的pom.xml，检查Profile里的build配置，必须包含这个插件的repackage执行目标：

  <profiles>
      <profile>
          <id>your-profile-id</id>
          <build>
              <plugins>
                  <plugin>
                      <groupId>org.springframework.boot</groupId>
                      <artifactId>spring-boot-maven-plugin</artifactId>
                      <executions>
                          <execution>
                              <goals>
                                  <goal>repackage</goal>
                              </goals>
                          </execution>
                      </executions>
                  </plugin>
              </plugins>
          </build>
      </profile>
  </profiles>
  

• 构建命令要确保激活了你的Profile，并且执行了package阶段：

  mvn clean package -P your-profile-id
  

  repackage目标会把Maven默认生成的普通Jar转换成包含所有依赖的可执行Jar，没加这个的话，你的Jar就是个普通Jar，自然会报依赖缺失。

4. 排查运行命令的细节问题 #

有时候命令的小细节也会导致奇怪的报错：

• 确保用的是java -jar your-app.jar这个标准命令，别漏了-jar参数
• 如果你的Jar文件名或路径包含空格（比如Windows系统下的My App.jar），要给路径加引号：

  java -jar "target\My App-1.0.jar"
  

• 检查Java版本是否符合Spring Boot的要求：比如Spring Boot 3.x需要Java 17及以上，2.x需要Java 8及以上，版本不兼容可能会抛出类似依赖缺失的错误（其实是类加载失败）。

5. 如果还是报依赖缺失，深入排查依赖打包情况 #

如果上面的步骤都没问题，但还是提示某个依赖找不到：

• 用jar tf your-app.jar | grep "missing-dependency-name"（替换成缺失的依赖名），看看这个依赖是否在BOOT-INF/lib里
• 如果不在，执行mvn dependency:tree -P your-profile-id查看依赖树，确认这个依赖是否被正确引入，有没有被排除，或者是否设置了<scope>provided</scope>（这种依赖不会被打包进Jar）
• 检查Profile里有没有特殊的依赖排除配置，比如<exclusions>标签，可能不小心把需要的依赖排除了。

如果做完这些还是解决不了，可以把具体的报错信息、你的Maven Profile配置片段，还有MANIFEST.MF的内容贴出来，我再帮你进一步分析。

内容的提问来源于stack exchange，提问作者Chad Van De Hey