Spring Data JPA Repository查询方法在测试环境中失效问题求助

核心问题分析 #

你遇到的查询失效问题主要来自两个方面：

• 关联查询的默认行为：当使用findTestUsersByFavouriteColorNotNull()这类基于关联实体的查询时，Spring Data JPA默认会生成**内连接（INNER JOIN）**语句。如果数据库中存在FavouriteColorId有值但对应FavouriteColor实体不存在的记录（数据无外键约束导致不一致），内连接会直接过滤掉这些记录；但findAll()加载实体时，JPA会尝试加载关联实体，找不到则设为null，手动过滤如果只看favouriteColorId不为null，就会出现结果差异。
• 重复字段映射的歧义：你同时维护了favouriteColorId基本类型字段和favouriteColor关联实体，且关联字段设置了insertable=false, updatable=false。这种双重映射会让Spring Data JPA在解析查询方法时产生歧义，尤其是对关联实体的null判断逻辑，容易生成不符合预期的SQL。

针对性解决方案 #

方案1：直接基于外键字段查询（快速修复） #

既然已经显式维护了favouriteColorId字段，直接针对这个字段做null判断是最可靠的，避免关联查询的问题。在Repository接口中定义：

fun findByFavouriteColorIdIsNotNull(): List<TestUser>

如果方法名解析仍有问题，可手动用@Query指定JPQL：

@Query("SELECT u FROM TestUser u WHERE u.favouriteColorId IS NOT NULL")
fun getUsersWithFavouriteColor(): List<TestUser>

方案2：优化实体映射（推荐长期方案） #

同时维护外键字段和关联实体容易引发混淆，建议移除冗余的favouriteColorId字段，让JPA自动维护外键关联：
修改TestUser实体：

@Entity
class TestUser(
    @Id
    @Column(name = "TestUserId")
    var userId: Long,
    @Column(name = "Name")
    var name: String,
    @OneToOne
    @JoinColumn(
        name = "FavouriteColorId",
        referencedColumnName = "FavouriteColorId",
        nullable = true
    )
    var favouriteColor: FavouriteColor? = null
)

此时findByFavouriteColorIsNotNull()就能正常工作，JPA会生成正确的存在性判断SQL，直接筛选出关联实体不为null的用户。

方案3：校验数据库数据一致性 #

检查TestUser表中所有FavouriteColorId不为null的记录，确保在FavouriteColor表中都有对应的主键记录。如果存在数据不一致（比如外键未加约束导致的无效关联），即使favouriteColorId有值，关联查询也会因为内连接过滤掉这些记录，和手动过滤结果产生差异。

调试技巧 #

开启SQL日志可以直接查看Spring Data JPA生成的查询语句，快速定位问题：
在application.yml中添加配置：

spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true

执行查询时就能看到控制台输出的格式化SQL，对比预期逻辑即可找到问题根源。

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