在 Spring Data JPA 中，无法直接对 @Query 的 value 属性使用字符串格式化（因要求编译期常量），但可通过拼接静态常量字符串实现安全、可维护的原生查询复用。
在 spring data jpa 中，无法直接对 `@query` 的 `value` 属性使用字符串格式化（因要求编译期常量），但可通过拼接静态常量字符串实现安全、可维护的原生查询复用。
当多个原生 SQL 查询仅在 SELECT 和 GROUP BY 字段上存在差异（如 table1.a1 vs table1.a2），而其余逻辑（表连接、聚合函数、过滤条件等）完全相同时，硬编码重复语句会显著降低可维护性，并增加出错风险。虽然直觉上想用 String.format() 动态生成 SQL，但 Java 注解属性值必须是编译期常量表达式，因此以下写法非法：
// ❌ 编译错误：The value for annotation attribute Query.value must be a constant expression
@Query(value = String.format("select table1.%s, ... group by table1.%s", "a1"), nativeQuery = true)✅ 正确解法是将查询的固定前缀与后缀定义为 public static final String 常量，再通过字符串拼接构造完整 SQL —— 因为常量字符串字面量拼接在编译期即被优化为单一常量，完全满足注解约束：
public interface YourRepository extends JpaRepository<Table2, Long> {
// ✅ 定义可复用的 SQL 基础片段（注意末尾不带空格或分号）
public static final String COMMON_AGGREGATE_PREFIX =
"SELECT table1.%s, SUM(table2.b), SUM(table2.c) FROM table2 " +
"JOIN table1 ON table2.table1_id = table1.id GROUP BY table1.";
@Query(value = COMMON_AGGREGATE_PREFIX + "a1", nativeQuery = true)
List<FooDTO> getAggregateSumWithGroupByA1();
@Query(value = COMMON_AGGREGATE_PREFIX + "a2", nativeQuery = true)
List<FooDTO> getAggregateSumWithGroupByA2();
}⚠️ 注意事项：
- 常量必须声明为 public static final（final 是关键，确保编译期不可变）；
- 拼接时避免在常量末尾添加多余空格或换行，防止 SQL 语法错误；
- 若后续需支持更多字段（如 a3, a4），只需新增方法并拼接对应字段名，无需修改 SQL 逻辑；
- 此方案不适用于运行时动态字段（如用户输入列名），此时应改用 JdbcTemplate 或 EntityManager#createNativeQuery 手动构建查询，以规避 SQL 注入风险。
该方式在保持类型安全、编译检查和 Spring Data JPA 声明式便利性的同时，实现了 SQL 片段的集中管理与高效复用，是处理相似原生聚合查询的推荐实践。
