Spring Data JPA注入仓库遇自循环依赖：重命名类即可解决？

问题场景 #

之前习惯用MyBatis：先定义@Mapper接口，再注入到@Repository类中。照搬这个模式到Spring Data JPA时，编写了以下代码结构：

• TestEntity：实体类
• TestRepo：业务Repository接口
• JPATestRepo：继承JpaRepository的Spring Data Repository接口
• JPATestRepoImpl：实现TestRepo接口，并注入JPATestRepo

启动应用时控制台报错，提示JPATestRepoImpl存在自循环依赖，重启、清理重建项目都无法解决。但将JPATestRepoImpl重命名为TestRepoJPAImpl后，循环依赖问题自动消失。

代码中是否存在循环依赖？ #

从代码逻辑来看，不存在显性的循环依赖：JPATestRepoImpl注入的是JPATestRepo（Spring Data自动生成的代理类），并非自身引用。

问题根源 #

核心原因是Spring Data JPA的Repository实现类命名约定：

• 当定义一个继承JpaRepository的接口（如JPATestRepo），Spring Data会自动为其生成代理实现类，默认的自定义实现类命名规则是[Repository接口名] + Impl。
• 自定义的JPATestRepoImpl恰好符合这个命名规则，Spring会错误地将它识别为JPATestRepo的自定义实现类，而非TestRepo的实现类。此时Spring尝试用JPATestRepoImpl作为JPATestRepo的实现，但JPATestRepoImpl又注入了JPATestRepo，形成了循环依赖（Spring生成的代理类依赖你的实现类，你的实现类又依赖代理类）。
• 重命名为TestRepoJPAImpl后，不再匹配JPATestRepo的默认实现命名规则，Spring正确识别它是TestRepo的实现类，同时JPATestRepo由Spring正常生成代理实现，依赖关系恢复正常。

官方文档依据 #

Spring Data JPA官方文档明确了自定义Repository实现的命名规则：如果需要为Spring Data Repository接口添加自定义实现逻辑，默认约定是实现类名为Repository接口名 + Impl。如果你的类并非为该Repository接口做自定义实现，必须避免使用这个命名格式，否则会被Spring误识别，引发依赖问题。

内容的提问来源于stack exchange，提问作者CheongJu Not Apple