在 Spring Data JPA 中，无法直接使用变量拼接 @Query 的 value 属性（因其必须为编译期常量），但可通过静态常量字符串拼接实现安全、简洁的原生查询复用，避免重复代码并提升可维护性。
在 spring data jpa 中，无法直接使用变量拼接 `@query` 的 `value` 属性（因其必须为编译期常量），但可通过静态常量字符串拼接实现安全、简洁的原生查询复用，避免重复代码并提升可维护性。
当多个原生 SQL 查询仅在 SELECT 和 GROUP BY 子句中的字段名存在差异（如 a1 与 a2），而其余部分（表连接、聚合函数、WHERE 条件等）完全相同时，硬编码重复 SQL 不仅冗余，还易引发维护风险。虽然直觉上想用 String.format() 动态生成语句，但 Java 注解属性要求编译时常量表达式，因此以下写法非法：
// ❌ 编译错误：value 必须是常量表达式
@Query(value = String.format("select table1.%s, ... group by table1.%s", "a1"), nativeQuery = true)✅ 正确解法是利用 public static final String 常量进行字符串字面量拼接——JVM 在编译期即可确定其值，完全符合注解约束：
public interface FooRepository extends JpaRepository<Table2, Long> {
// ✅ 定义公共查询前缀（不含 GROUP BY 字段）
public static final String BASE_AGGREGATE_QUERY =
"SELECT table1.%s, SUM(table2.b), SUM(table2.c) " +
"FROM table2 " +
"JOIN table1 ON table2.table1_id = table1.id " +
"GROUP BY table1.%s";
@Query(value = BASE_AGGREGATE_QUERY.replace("%s", "a1"), nativeQuery = true)
List<FooDTO> getAggregateSumWithGroupByA1();
@Query(value = BASE_AGGREGATE_QUERY.replace("%s", "a2"), nativeQuery = true)
List<FooDTO> getAggregateSumWithGroupByA2();
}? 为什么 replace() 可行？
BASE_AGGREGATE_QUERY 是 static final String，属于编译期常量；replace() 在编译时被内联优化为字面量字符串（如 "SELECT table1.a1, ... GROUP BY table1.a1"），满足 @Query.value 的常量要求。
? 进阶建议：
- 若字段数量较多，可提取为枚举或配置项，配合 @Query + @Param 实现运行时动态（需改用 JPQL 或自定义 JdbcTemplate）；
- 对复杂动态场景，推荐使用 JdbcTemplate 封装查询逻辑，将 SQL 拼接移至 service 层，保持 repository 职责清晰；
- 所有原生查询务必配合同名 DTO 构造器（如 new FooDTO(table1_a1, sum_b, sum_c)）或 @SqlResultSetMapping，确保类型安全。
通过静态常量拼接，既遵守了 Spring 注解规范，又实现了逻辑复用，是兼顾简洁性与可靠性的最佳实践。
