Spring Data JPA含特殊关键字属性名的Repository方法报错咨询

这个问题我之前也碰到过！Spring Data JPA的方法名解析逻辑会把Or这类查询关键字当成条件分隔符，而不是字段名的一部分，所以才会错误地把nameOrId拆成name和Id去匹配实体属性，导致“找不到name属性”的报错。下面给你几个可行的解决方案：

方案一：使用@Query注解手动指定查询（推荐） #

直接通过JPQL语句精准匹配实体字段，完全绕过方法名解析器的歧义问题：

public interface MyObjRepository extends JpaRepository<MyObj, String> {
    @Query("SELECT m FROM MyObj m WHERE m.nameOrId = :nameOrId")
    MyObj findByNameOrId(@Param("nameOrId") String nameOrId);
}

这种方式最直观，也不会受方法名关键字的限制，尤其适合字段名包含Or、And、Between这类JPA查询关键字的场景。

方案二：用下划线转义关键字 #

Spring Data JPA支持用下划线_来转义查询关键字，让解析器把关键字当作字段名的一部分。修改方法名后，解析器会自动将下划线格式转换为驼峰格式匹配实体字段：

public interface MyObjRepository extends JpaRepository<MyObj, String> {
    MyObj findByName_OrId(String nameOrId);
}

这里的name_OrId会被解析为驼峰式的nameOrId，刚好匹配你的实体类字段，不会再把Or当成查询条件分隔符。

如果你的字段名里还有其他类似的查询关键字（比如And、Like），都可以用同样的下划线方式转义，但相比之下@Query的可读性和稳定性更高，更推荐优先使用。

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