Spring JPA仓库方法无法识别主外键的问题排查

仓库代码 #

public interface CrimeCaseRepository extends JpaRepository<CrimeCase, Integer> {
    boolean existsByCrimeId(int crimeId);
}

CrimeCase实体 #

...
    @Id
    @Column(name = "fk_crime")
    private Integer crimeId;

    @OneToOne(fetch = FetchType.LAZY)
    @MapsId
    private Crime crime;
...

Crime实体 #

...
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;

    @OneToOne(mappedBy = "crime", fetch = FetchType.LAZY)
    private CrimeCase crimeCase;
...

数据库表结构 #

CREATE TABLE crime (
  id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
...
);

CREATE TABLE crime_case (
  fk_crime INTEGER PRIMARY KEY,
...
);

Hibernate输出SQL #

Hibernate: select cc1_0.crime_id from crime_case cc1_0 where cc1_0.crime_id=? fetch first ? rows only

异常信息 #

org.postgresql.util.PSQLException: ERROR: column cc1_0.crime_id does not exist

即使将字段crimeId重命名为fkCrime，仍会触发该异常，预期应关联Crime实体的id字段。

问题原因 #

JPA的方法名解析机制会将existsByCrimeId中的crimeId按驼峰转下划线规则生成crime_id列名，但数据库中实际列名为fk_crime，导致列不存在异常。同时@MapsId的关联配置让JPA在解析属性时出现混淆，无法正确映射到目标列。

解决方案 #

方案1：自定义查询语句（推荐）

直接在Repository方法上使用@Query注解指定正确的SQL逻辑，避免JPA自动解析出错：

public interface CrimeCaseRepository extends JpaRepository<CrimeCase, Integer> {
    @Query(value = "SELECT EXISTS(SELECT 1 FROM crime_case WHERE fk_crime = ?1)", nativeQuery = true)
    boolean existsByCrimeId(int crimeId);
}

或者使用JPQL版本：

public interface CrimeCaseRepository extends JpaRepository<CrimeCase, Integer> {
    @Query("SELECT CASE WHEN COUNT(cc) > 0 THEN true ELSE false END FROM CrimeCase cc WHERE cc.crimeId = :crimeId")
    boolean existsByCrimeId(@Param("crimeId") int crimeId);
}

方案2：调整方法名匹配列映射

如果实体字段改为fkCrime并保留@Column(name = "fk_crime")，可以将方法名改为existsByFkCrime，让JPA正确解析到目标列：

public interface CrimeCaseRepository extends JpaRepository<CrimeCase, Integer> {
    boolean existsByFkCrime(int crimeId);
}

方案3：修改全局命名策略

如果项目中需要统一处理列名映射，可以配置Hibernate的命名策略，让驼峰命名直接映射到指定列名，但这种方式会影响全局实体，需谨慎使用。

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