Spring自定义@Query中如何添加自增计数器？

首先明确：完全不需要在查询后遍历列表手动加序号，Spring Data JPA的@Query支持嵌入数据库原生的行号生成语法，只要你的数据库支持这种功能就行。下面分主流数据库给出具体实现：

1. MySQL/MariaDB 写法 #

MySQL可以用ROW_NUMBER()窗口函数（需要MySQL 8.0+），低版本则可以用自定义变量：

窗口函数版本（推荐，MySQL8+） #

@Query(value = "SELECT new com.mypackage.CmcXml(ROW_NUMBER() OVER(ORDER BY c.nom), c.nom, c.prenom, c.genre) FROM Cmc c")
List<CmcXml> getExportCmc();

低版本MySQL（<8.0）用变量 #

@Query(value = "SELECT new com.mypackage.CmcXml(@row := @row + 1, c.nom, c.prenom, c.genre) FROM Cmc c, (SELECT @row := 0) r", nativeQuery = true)
List<CmcXml> getExportCmc();

注意：低版本写法需要开启nativeQuery=true，因为用到了MySQL自定义变量，JPQL本身不支持这类语法。

2. PostgreSQL 写法 #

PostgreSQL原生支持ROW_NUMBER()窗口函数，直接使用即可：

@Query(value = "SELECT new com.mypackage.CmcXml(ROW_NUMBER() OVER(ORDER BY c.nom), c.nom, c.prenom, c.genre) FROM Cmc c")
List<CmcXml> getExportCmc();

这里的ORDER BY可以按需调整，比如按主键c.id排序，能保证每次查询的序号稳定一致。

3. Oracle 写法 #

Oracle同样支持ROW_NUMBER()窗口函数，也可以用ROWNUM（但要注意排序逻辑）：

窗口函数版本（推荐） #

@Query(value = "SELECT new com.mypackage.CmcXml(ROW_NUMBER() OVER(ORDER BY c.nom), c.nom, c.prenom, c.genre) FROM Cmc c")
List<CmcXml> getExportCmc();

ROWNUM版本（注意排序顺序） #

如果用ROWNUM，必须先排序再编号，否则序号会混乱：

@Query(value = "SELECT new com.mypackage.CmcXml(rn, nom, prenom, genre) FROM (SELECT c.*, ROWNUM rn FROM Cmc c ORDER BY c.nom)")
List<CmcXml> getExportCmc();

关键注意事项 #

• 你的CmcXml类必须存在对应参数顺序的构造函数，字段顺序要和查询中的返回顺序完全匹配：

  public class CmcXml {
      private Integer counter;
      private String nom;
      private String prenom;
      private String genre;
  
      // 对应查询返回顺序的构造函数
      public CmcXml(Integer counter, String nom, String prenom, String genre) {
          this.counter = counter;
          this.nom = nom;
          this.prenom = prenom;
          this.genre = genre;
      }
  
      // getter/setter 按需添加
  }
  

• 使用窗口函数时，ORDER BY子句是部分数据库的强制要求，建议选择业务上稳定的排序字段（比如主键），避免序号随查询结果波动。
• 如果使用原生SQL语法（比如MySQL低版本的变量写法），一定要记得添加nativeQuery=true参数。

总结 #

完全可以直接在@Query中实现自增计数器，不需要事后遍历列表处理，只要根据你的数据库类型选择对应的语法即可。

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