Spring Boot项目IntelliJ可运行但Jar启动失败且不识别环境配置

核心原因 #

Spring Boot 3中entityManagerFactory由Spring Data JPA自动配置生成，Jar启动时缺失该Bean，通常和打包配置不全、依赖范围错误、JPA配置未加载或自动配置被意外排除有关。

具体排查修复步骤 #

1. 检查Maven打包配置（pom.xml） #

• 确保Spring Boot Maven插件配置正确，必须包含repackage目标，否则生成的Jar无法正常启动：

  <build>
      <plugins>
          <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
              <!-- 自定义主类时需指定，否则可省略 -->
              <configuration>
                  <mainClass>com.yourpackage.TripReimbursementAppApplication</mainClass>
              </configuration>
              <executions>
                  <execution>
                      <goals>
                          <goal>repackage</goal>
                      </goals>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

• 检查JPA相关依赖的scope，禁止设为provided或test（这类依赖不会被打包进Jar）：

  <!-- 正确依赖示例 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  <dependency>
      <groupId>com.mysql</groupId>
      <artifactId>mysql-connector-j</artifactId>
      <!-- runtime范围是合法的，Spring Boot会自动处理 -->
      <scope>runtime</scope>
  </dependency>
  

2. 验证主类注解配置 #

Spring Boot 3中主类只需标注@SpringBootApplication即可，它已包含@EnableAutoConfiguration（自动配置JPA），除非实体类/Repository不在主类同级或子包，否则不要手动添加@EnableJpaRepositories或@EntityScan：

@SpringBootApplication
// 仅当实体/Repository路径特殊时才需要指定，否则删除以下两行
// @EntityScan(basePackages = "com.yourpackage.entity")
// @EnableJpaRepositories(basePackages = "com.yourpackage.repository")
public class TripReimbursementAppApplication {
    public static void main(String[] args) {
        SpringApplication.run(TripReimbursementAppApplication.class, args);
    }
}

3. 确认环境配置文件被正确打包 #

• 执行jar tf Trip-Reimbursement-App.jar，检查输出中是否存在BOOT-INF/classes/application-dev.properties（或yml），确保配置文件被打包进Jar。
• 启动命令的参数顺序要正确，-D参数必须放在-jar前面：

  java -Dspring.profiles.active=dev -jar Trip-Reimbursement-App.jar
  

4. 排查JPA自动配置是否被排除 #

检查主类或配置类是否有@SpringBootApplication(exclude = ...)排除了JPA相关自动配置类（比如HibernateJpaAutoConfiguration），如果有，移除该排除项。

5. 清理缓存并重新打包 #

执行以下命令彻底清理旧构建文件，避免缓存干扰：

mvn clean package -DskipTests

使用新生成的Jar文件重新启动测试。

6. 查看详细启动日志 #

添加-Ddebug参数打印自动配置细节，排查JPA配置是否被跳过：

java -Dspring.profiles.active=dev -Ddebug -jar Trip-Reimbursement-App.jar

在日志中搜索EntityManagerFactoryAutoConfiguration，查看是否有条件不满足导致自动配置未生效。

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