JQPL使用DBMS_LOB.SUBSTR函数时IntelliJ IDE无法识别的问题求助

问题核心 #

JQPL本身不支持直接调用Oracle的DBMS_LOB.SUBSTR这类数据库特定函数，同时你的代码存在拼写错误（Prodcut应为Product），这两个问题共同导致了IDE识别失败和SQL转换异常。

解决步骤 #

• 用JPA FUNCTION()语法包裹数据库原生函数
  JPA提供了FUNCTION()标准语法来调用数据库特定函数，它会告诉JQPL解析器直接将函数传递到目标数据库执行，同时能让IntelliJ IDE正确识别语法。
• 修正实体类拼写错误
  原代码中FROM Prodcut p的Prodcut是拼写错误，需改为实体类正确名称Product。

修改后的完整代码 #

@Query("SELECT distinct new com.product.dto.ProductDescriptionsDto(" +
        "p.id, p.type, FUNCTION('DBMS_LOB.SUBSTR', p.description, 4000, 1)) " +
        "FROM Product p " +
        "WHERE p.code = :code and p.language = :language")
List<ProductDescriptionsDto> find(@Param("code") String code, @Param("language") String language);

补充说明 #

• 不需要额外的CAST(... AS string)，因为DBMS_LOB.SUBSTR返回的字符类型可以直接映射到Java的String，JPA会自动处理类型转换。
• 如果你使用的是Hibernate 5.2+版本，也可以用@Formula在实体类中预先定义这个字段，但在查询中直接用FUNCTION()更灵活。

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