JPA Query中NOT LIKE无法过滤IP的问题排查求助

问题概述 #

• 数据库列类型为INET，实体类映射为String类型
• 需通过JPQL筛选结尾不是.1的网关IP
• 尝试过的JPQL写法及问题：
  • 硬写条件：...AND concat(c.ip,'') not LIKE '%.1'，生成的SQL为AND NOT (c_ip || ? LIKE ?))，无法生效
  • 参数绑定：concat(c.ip,'') not LIKE :excludedValue，绑定query.setParameter("excludedValue","%.1");，仍无效果
  • 相同的concat+LIKE语句在SQL IDE中可正常执行，但因需返回实体列表，无法使用原生SQL

可行解决方案 #

1. 强制类型转换后匹配 #

直接用JPA标准函数或CAST将INET转为字符串，避免JPA对concat的异常解析：

// 使用JPA标准FUNCTION调用数据库TEXT函数（适配PostgreSQL）
String jpql = "...AND FUNCTION('TEXT', c.ip) NOT LIKE '%.1'";

或者用CAST语法（部分JPA实现如Hibernate支持）：

String jpql = "...AND CAST(c.ip AS string) NOT LIKE '%.1'";

2. 调整参数绑定方式 #

把通配符和后缀分开拼接，避免JPA对%.1整体参数的转义：

// JPQL语句
String jpql = "...AND concat(c.ip, '') NOT LIKE concat('%', :suffix)";
// 参数绑定
query.setParameter("suffix", ".1");

3. 用字符串截取精准判断 #

调用数据库原生函数截取IP字符串最后两位，直接对比：

// PostgreSQL环境下的JPQL写法
String jpql = "...AND FUNCTION('RIGHT', c.ip::text, 2) != '.1'";

问题根源 #

JPA解析concat(c.ip,'')时，会把空字符串解析为参数占位符（即生成c_ip || ?），实际执行时拼接的是占位符参数而非空字符串，导致INET转字符串的逻辑失效；而SQL IDE中直接执行时，concat(c.ip,'')会被解析为c_ip || ''，能正确完成类型转换并匹配。

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