Spring应用启动报错：EntityManager类型转换失败，求解决方案

核心问题分析 #

你遇到的类型转换错误，本质是JPA API版本冲突或EntityManager注入方式错误导致的代理类型不匹配：Spring容器生成的jdk.proxy2.$Proxy85代理类实现的是Hibernate Session和Spring的EntityManagerProxy，但你的代码试图将其转换为不兼容的javax.persistence.EntityManager类型，通常是因为javax和jakarta版本的JPA API混用，或者注入方式不对。

具体排查步骤 #

1. 核对Spring Boot版本与JPA API包 #

Spring Boot 2.x使用javax.persistence包，Spring Boot 3.x强制使用jakarta.persistence包，两者完全不兼容，混用时必然出现类型转换错误：

• 打开你的pom.xml，找到spring-boot-starter-parent的版本：

  <!-- Spring Boot 2.x示例 -->
  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.7.15</version>
  </parent>
  
  <!-- Spring Boot 3.x示例 -->
  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>3.2.0</version>
  </parent>
  

• 确保所有JPA相关依赖和代码导入，都与Spring Boot版本匹配：
  • Boot 2.x：用javax.persistence.*
  • Boot 3.x：用jakarta.persistence.*

2. 清理冲突的JPA依赖 #

spring-boot-starter-data-jpa已经默认引入了对应版本的JPA API，不要手动添加额外的javax.persistence-api或jakarta.persistence-api依赖，否则会导致版本冲突。

• 移除pom中类似以下的手动依赖：

  <!-- 错误示例：不要手动添加 -->
  <dependency>
      <groupId>javax.persistence</groupId>
      <artifactId>javax.persistence-api</artifactId>
      <version>2.2</version>
  </dependency>
  

3. 修正EntityManager注入方式 #

不要用@Autowired注入EntityManager，必须用JPA专属的@PersistenceContext注解，它能正确处理Spring生成的代理类：

// 对应Spring Boot 2.x
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

// 对应Spring Boot 3.x
// import jakarta.persistence.EntityManager;
// import jakarta.persistence.PersistenceContext;

@Service
public class SessionService {
    @PersistenceContext
    private EntityManager entityManager;

    // 业务代码...
}

4. 检查Repository定义 #

确保你的UserRepository正确继承Spring Data JPA的JpaRepository，不要自定义需要直接操作EntityManager的实现（除非你明确知道如何处理代理）：

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    // 自定义查询方法...
}

验证步骤 #

1. 清理项目依赖：执行mvn clean install -U强制更新依赖
2. 替换所有代码中JPA相关的导入包，确保与Spring Boot版本一致
3. 重新启动应用，检查Bean注入是否正常

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