Spring Boot启动Tomcat失败：JPA依赖注入异常排查与修复

错误含义解析 #

这条异常链的核心逻辑是：

• org.springframework.beans.factory.UnsatisfiedDependencyException：Spring容器创建Bean时，无法满足某一依赖的注入需求，本质是依赖链上游的核心Bean初始化失败。
• 根源问题是tokenRepository依赖的jpaSharedEM_entityManagerFactory Bean无法被解析：该Bean是Spring Data JPA自动生成的EntityManagerFactory代理类，说明JPA相关配置或组件存在问题，导致Spring无法初始化这个核心Bean，进而牵连JwtTokenService、JwtRequestFilter等下游依赖Bean创建失败。

修复步骤 #

1. 检查JPA相关依赖完整性（针对pom.xml） #

确保Spring Data JPA和数据库驱动依赖正确引入，无版本冲突：

<!-- Spring Data JPA核心依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- 对应数据库驱动示例（MySQL） -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

避免手动引入Hibernate核心包（Spring Boot Starter已包含），防止版本不兼容。

2. 验证application.properties中的JPA配置 #

• 确认数据库连接信息正确，且数据库服务已启动：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC
  spring.datasource.username=your_username
  spring.datasource.password=your_password
  

• 检查JPA实体扫描与Hibernate配置：

  spring.jpa.hibernate.ddl-auto=update
  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
  # 若实体类不在主包下，需指定扫描路径
  spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
  

注意：spring.jpa.hibernate.ddl-auto不要设为none（除非手动建表），否则Hibernate无法初始化实体映射，导致Repository无法关联EntityManager。

3. 检查Token实体类的JPA注解正确性 #

确保实体类标注规范，主键与关联关系配置无误：

@Entity
@Table(name = "tokens")
public class Token {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(unique = true, nullable = false)
    private String token;
    
    private boolean expired;
    private boolean revoked;
    
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id")
    private User user;
    
    // getter、setter、构造方法
}

同时确认实体类所在包在Spring扫描范围内，可通过@SpringBootApplication(scanBasePackages = "com.your.package")指定扫描路径。

4. 确认TokenRepository的定义符合Spring Data JPA规范 #

确保Repository接口继承JpaRepository，自定义查询方法命名符合规则：

public interface TokenRepository extends JpaRepository<Token, Long> {
    List<Token> findByUserIdAndExpiredFalseAndRevokedFalse(Long userId);
}

无需给Repository接口添加@Repository注解（Spring Data JPA会自动生成代理实现类），多余注解可能引发冲突。

5. 检查JwtTokenService的依赖注入方式 #

优先使用构造方法注入TokenRepository，避免字段注入可能导致的初始化顺序问题：

@Service
public class JwtTokenService {
    private final TokenRepository tokenRepository;
    
    // 构造方法注入
    public JwtTokenService(TokenRepository tokenRepository) {
        this.tokenRepository = tokenRepository;
    }
    
    // 业务方法逻辑
}

6. 排查循环依赖问题 #

检查JwtRequestFilter、JwtTokenService、TokenRepository之间是否存在循环依赖（如Filter依赖Service，Service依赖Repository，Repository间接依赖Filter）。可通过@Lazy注解延迟加载某一依赖，或重构代码打破循环。

内容的提问来源于stack exchange，提问作者trying to be alive