如何使用JPA原生查询实现Clob与字符串的比对过滤？

云原生阿岚

2026-8-24

实现JPA原生查询过滤Clob字段包含指定内容

针对Oracle数据库的正确实现

你提供的示例代码存在参数绑定问题，直接将:username写在字符串中无法正确绑定参数，还会存在SQL注入风险。正确写法需将参数作为独立占位符传递：

@Repository
public interface DummyRepository extends JpaRepository<DummyEntity, Integer> {
    @Query(value = "SELECT * FROM DUMMY WHERE DBMS_LOB.INSTR(PARTICIPANTS, :username) > 0", nativeQuery = true)
    List<DummyEntity> findByParticipant(@Param("username") String username);
}

说明：

DBMS_LOB.INSTR是Oracle专门用于处理CLOB/BLOB类型的字符串查找函数，返回目标字符串在CLOB中的起始位置，返回值大于0即表示包含指定用户名。
通过@Param("username")将方法参数与SQL中的占位符绑定，确保参数安全传递。

其他数据库的适配方案

不同数据库处理CLOB的函数存在差异，以下是常见数据库的实现方式：

MySQL

MySQL会自动将CLOB转为字符串处理，可使用LOCATE函数或LIKE：

// 使用LOCATE函数
@Query(value = "SELECT * FROM DUMMY WHERE LOCATE(:username, PARTICIPANTS) > 0", nativeQuery = true)
List<DummyEntity> findByParticipant(@Param("username") String username);

// 使用LIKE
@Query(value = "SELECT * FROM DUMMY WHERE PARTICIPANTS LIKE CONCAT('%', :username, '%')", nativeQuery = true)
List<DummyEntity> findByParticipant(@Param("username") String username);

PostgreSQL

PostgreSQL中CLOB对应TEXT类型，可使用POSITION函数：

@Query(value = "SELECT * FROM DUMMY WHERE POSITION(:username IN PARTICIPANTS) > 0", nativeQuery = true)
List<DummyEntity> findByParticipant(@Param("username") String username);