如何在Spring JPA原生查询结果中添加序列号？遇参数未设置报错

这个问题我之前在项目里也踩过坑，本质是Hibernate对SQL语法的解析逻辑和原生MySQL不一样导致的——它把你用来定义MySQL用户变量的@和:=符号当成了JPA的命名参数标记，所以才会抛出Not all named parameters have been set: [0, @rownumber]的错误。

下面给你几个靠谱的解决思路：

1. 转义MySQL变量符号，让Hibernate忽略它们 #

你可以用MySQL的注释技巧，把@符号包裹在特定注释里，让Hibernate不把它识别为参数，同时保留MySQL能解析的变量语法：

SELECT /*'*/@rownumber/*'*/:=/*'*/@rownumber/*'*/+1 as rownumber, `column` 
FROM `Table`, (SELECT /*'*/@rownumber/*'*/:=0) D

原理是：Hibernate会跳过/*'*/和/*'*/之间的内容，而MySQL会忽略注释部分，正常解析@rownumber变量。注意要给关键字（比如column、Table）加上反引号，避免和SQL关键字冲突。

2. 改用标准SQL窗口函数（推荐） #

如果你的MySQL版本是8.0+（或者其他支持窗口函数的数据库），完全可以用ROW_NUMBER()窗口函数替代MySQL用户变量，这是更符合JPA规范的写法，也不会有解析冲突：

SELECT ROW_NUMBER() OVER(ORDER BY `column`) as rownumber, `column` 
FROM `Table`

在Spring Data JPA里，你只需要在查询方法上加上@Query(nativeQuery = true)（如果用原生SQL），或者如果你的JPA实现支持JPQL窗口函数，直接写JPQL即可。这种方式不需要依赖数据库特定的变量语法，兼容性更强。

3. 分两步执行：先初始化变量，再查询 #

你可以在同一个事务里，先执行初始化变量的SQL，再执行带变量的查询。用EntityManager来实现：

// 确保在事务内执行
entityManager.createNativeQuery("SET @rownumber := 0").executeUpdate();
List<Object[]> results = entityManager.createNativeQuery(
    "SELECT @rownumber:=@rownumber+1 as rownumber, `column` FROM `Table`"
).getResultList();

这种方式的关键是要保证两个操作在同一个事务中，否则MySQL会话变量会失效。如果你用Spring Data JPA，可以给方法加上@Transactional注解。

4. 调整Hibernate配置（不推荐） #

可以通过修改Hibernate的配置参数，让它对原生SQL的解析更宽松：
在application.properties或application.yml里添加：

spring.jpa.properties.hibernate.query.legacy_sql_handling_mode=LEGACY

这个配置会让Hibernate采用旧版的SQL解析逻辑，不再把@识别为参数标记。但不推荐用这种方式，因为可能影响其他查询的参数解析，带来潜在的兼容性问题。

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