JPA中findBy查询两个同名属性返回空结果如何解决？

问题场景 #

实体Character与Category均包含name属性，二者通过@ManyToOne关联。使用Spring Data JPA的方法命名查询findByNameAndCategory_Name时，明明数据库存在匹配数据，却始终抛出EmptyResultDataAccessException异常。

解决方案（不修改属性名） #

方法1：使用@Query注解自定义JPQL查询 #

通过JPQL明确指定字段归属，彻底消除JPA解析歧义：

@Repository
interface CharacterRepository : JpaRepository<Character, Long> {

    @Query("SELECT c FROM Character c WHERE c.name = :name AND c.category.name = :categoryName")
    fun findByNameAndCategoryName(@Param("name") name: String, @Param("categoryName") categoryName: String): Optional<Character>
}

• 用Optional<Character>作为返回类型，避免无匹配数据时抛出Result must not be null异常，符合Spring Data最佳实践
• 通过c.name和c.category.name明确区分两个实体的name属性，杜绝解析歧义

方法2：检查关联字段的约束配置 #

确认Category的name属性是否为唯一值：
因为你在Character的@JoinColumn中指定了referencedColumnName = "name"，如果Category的name没有唯一约束，可能存在多个匹配分类，导致查询逻辑不符合预期。可以给Category的name添加唯一约束：

@Entity
class Category (
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null,

    @Column(unique = true)
    var name: String? = null,

    @OneToMany(mappedBy = "category") @JsonIgnore
    var characters: MutableSet<Character> = mutableSetOf()
) : Serializable

方法3：修正方法命名查询的返回类型 #

如果坚持使用方法命名查询，将返回类型改为Optional<Character>，既避免异常，也能验证查询结果：

@Repository
interface CharacterRepository : JpaRepository<Character, Long> {

    fun findByNameAndCategory_Name(name: String, categoryName: String): Optional<Character>
}

关键说明 #

当关联实体存在同名属性时，JPA方法命名查询可能出现解析歧义，手动编写JPQL是最可靠的解决方式。同时要确保关联字段的约束符合业务逻辑，避免数据层面的匹配问题。

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