Spring JPA的@Query参数无法识别正确Entity实体类名称问题

安全阿岳

2026-10-5

问题解决方案

根因说明

该问题的核心是JPA默认规则引发的实体名冲突：如果@Entity注解没有显式指定name属性，JPA会默认将类名作为实体名称注册到上下文。你的两个区域同名Transaction实体都被加载到亚洲应用的JPA上下文时，HQL查询中直接写类名Transaction会匹配到后注册的欧洲区域实体，最终引发字段识别错误。

可落地解决方案

方案1：给实体指定唯一显式名称（最推荐）
给两个区域的Transaction实体分别指定专属的实体名避免冲突：
亚洲区域实体加注解：@Entity(name = "AsiaTransaction")
欧洲区域实体加注解：@Entity(name = "EuropeTransaction")
然后修改Repository中的@Query语句即可：
```
@Query("select ai from AsiaTransaction ai where ai.name = :name")
Stream<com.test.asia.Transaction> findTransactionByName(@Param("name") String name);
```
注：你的原代码还有三处笔误：HQL条件缺少=号、泛型和返回值的类名拼写为Transction（少了字母a）、@Param注解后缺少参数类型，建议同步修正。
方案2：HQL中直接使用全限定类名
不需要修改实体注解，直接在查询语句中写亚洲实体的完整包路径即可直接匹配到目标类：
```
@Query("select ai from com.test.asia.Transaction ai where ai.name = :name")
```
方案3：限制亚洲应用的实体扫描范围
在亚洲应用的启动类上添加@EntityScan注解，仅扫描亚洲区域的实体包，从根源上避免欧洲实体被加载到上下文：
```
@SpringBootApplication
@EntityScan(basePackages = "com.test.asia")
public class AsiaApplication {
    public static void main(String[] args) {
        SpringApplication.run(AsiaApplication.class, args);
    }
}
```
该方案下不需要修改原有@Query的实体名写法，JPA上下文仅存在一个Transaction实体，自动匹配到亚洲版本。