JPA @Query命名参数大于比较时字符串参数被截断问题咨询

问题根因 #

该参数截断问题主要有三种可能性，按出现概率从高到低排列：

1. JPQL语句拼接缺失空格导致语法解析异常
   你提供的代码中，SELECT子句的结尾和FROM关键字之间没有空格，拼接后的完整JPQL语句为：

SELECT new com.model.Result(am.product, am.age)FROM Table am WHERE am.age > :age

部分JPA实现（如低版本Hibernate）解析这类缺失空格的语句时，会错误将am.age)FROM识别为一个整体，最终仅取am.age的第一个字符参与比较；而等值查询的语法解析优先级更高，刚好绕开了这个解析bug，因此可以正常执行。
2. 字段类型隐式转换导致截断
如果数据库中age字段是定长字符类型（如CHAR(1)），或是实体类中age字段标注了@Column(length = 1)，执行大于比较时数据库会先将传入的字符串参数转换为和字段一致的长度，"488"会被截断为4参与比较；等值查询时部分数据库会做隐式的全值匹配校验，不会触发截断逻辑。
3. 字符串比较逻辑与预期不符
如果age在数据库中是字符串类型，JPQL中的>默认执行字典序逐位比较，而非数值大小比较：例如"49"、"5"的字典序都大于"488"，看起来像是仅取第一位"4"做比较，实际是比较逻辑和预期不符。

解决方案 #

• 优先修复JPQL的拼接空格问题，修改代码如下：

@Query("SELECT new com.model.Result(am.product, am.age) "
// 上述行末新增空格
        + "FROM Table am WHERE am.age > :age")
List<Result> queryResult(@Param("age") String age );

• 如果业务需求是按数值大小比较age，建议统一字段和参数类型：
  1. 将数据库age字段调整为数值类型（INT/BIGINT）
  2. 实体类age字段改为Integer/Long类型
  3. 接口参数同步修改为对应数值类型：

  List<Result> queryResult(@Param("age") Integer age );
  

• 如果必须用字符串类型存储age，可在查询时手动转为数值类型再比较（以适配MySQL的Hibernate实现为例）：

@Query("SELECT new com.model.Result(am.product, am.age) "
        + "FROM Table am WHERE CAST(am.age AS integer) > CAST(:age AS integer)")
List<Result> queryResult(@Param("age") String age );

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