spring-boot-starter-data-jpa 采坑记录 @EntityScan @Entity @Repository

最新推荐文章于 2025-09-13 09:48:44 发布

原创

最新推荐文章于 2025-09-13 09:48:44 发布 · 1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#spring #jpa #java #后端 #经验分享

在对一个高龄产品进行维护升级，从spring 2.X/4.X到spring的重构过程中，遇到使用spring-boot-starter-data-jpa的两个问题。问题一：Field Repository找不到bean；问题二：Hibernate查询语法异常，实体未映射。解决方案涉及@EntityScan、@Entity和@Repository的正确使用，以及模块间的Repository冲突和查询语句中的实体类名错误。

JPA采坑记录

背景
遇到的问题
- 1. Field xxxRepository in XXX required a bean of type 'XXXRepository' that could not be found.
- 2. org.hibernate.hql.internal.ast.QuerySyntaxException: xxx is not mapped

背景

最近在负责一个老产品的维护升级工作，此产品是个高龄产品，据说已经超过了十岁，产品代码结构中有公司自研的内容（已经无人维护），有spring 2.X的版本，有spring 4.X的版本，有ibatis也有jpa。
为了降低以后维护升级工作的难度，决定对产品代码做一次重构，去掉无法维护的自研框架，升级spring，统一持久化层使用jpa。在此过程中则遇到了一些问题在此留痕，希望能帮助到大家。

遇到的问题

1. Field xxxRepository in XXX required a bean of type ‘XXXRepository’ that could not be found.

异常信息：

Description:
Field xxxRepository in XXX required a bean of type 'XXXRepository' that could not be found.
Action:
Consider defining a bean of type 'XXXRepository' in your configuration.

遇到上边的异常信息去网上找一般都会被带到package是否被扫描，@EntityScan @Entity @Repository等注解是否添加上去，但是加上@EntityScan等一些网上的解决方式又引起了一系列其他问题。

后经过分析发现，由于产品采用的是不同模块的代码实现是通过不同的maven module来隔离的，产品经过了很长时间维护期，一些人为了方便在维护过程中并没有严格按照产品功能模块去写代码，原本应该在A模块的Repository在B模块的代码中已经存在了，从而造成了Repository加载异常问题。

解决办法：</