Spring Boot打包可运行JAR后JpaRepository Bean找不到问题求助

既然已经确认spring-boot-starter-data-jpa-2.7.5.jar在打包后的JAR里，但运行时还是报找不到Bean的错，从这几个方向查：

1. 包扫描范围没覆盖到Repository #

Spring Boot默认只扫主启动类所在包及其子包的组件。如果TutorialRepository的包不在主启动类的包层级下，本地IDE运行时可能因为类加载机制宽松能扫到，但打包成JAR后就严格按规则来，直接漏扫。

• 处理方式：要么把Repository移到主启动类的子包下；要么在主启动类上加@EnableJpaRepositories(basePackages = "你的Repository所在包路径")，明确指定扫描范围；也可以用@ComponentScan指定包含Repository的包。

2. Repository接口定义不对 #

得确保TutorialRepository是接口，而且正确继承了Spring Data JPA的父接口，比如JpaRepository：

public interface TutorialRepository extends JpaRepository<Tutorial, Long> {
    // 自定义查询方法
}

要是写成了类，或者没继承正确的父接口，Spring根本识别不了这是Repository，自然不会创建Bean。

3. 打包方式用错了 #

别用Eclipse自带的“导出可运行JAR”功能，这个生成的JAR不符合Spring Boot的标准结构，类加载会出问题。应该用Spring Boot官方的插件打包：

• Maven项目：在项目根目录执行mvn clean package spring-boot:repackage
• Gradle项目：执行gradle clean bootJar
  用这个方式生成的JAR才是Spring Boot标准可执行JAR，能正确处理依赖和类加载逻辑。

4. 主启动类注解不全 #

虽然本地运行正常，但可能IDE自动补了某些隐式配置，打包后就没了。@SpringBootApplication默认包含组件扫描，但如果Repository不在默认范围内，就得额外加@EnableJpaRepositories。检查下主启动类：

@SpringBootApplication
@EnableJpaRepositories(basePackages = "com.your.repo.package") // 按需添加
public class YourApp {
    public static void main(String[] args) {
        SpringApplication.run(YourApp.class, args);
    }
}

5. 依赖版本冲突 #

就算spring-boot-starter-data-jpa在JAR里，也可能有其他JPA相关依赖（比如hibernate-core）和Spring Boot 2.7.5版本不匹配，导致Repository Bean创建失败。

• 排查方法：用Maven命令mvn dependency:tree生成依赖树，看看有没有版本不一致的JPA相关依赖，把冲突的依赖排除掉，保证所有相关依赖和Spring Boot版本对齐。

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