当实体属性名与 SQL 保留关键字（如 order）冲突时，Spring Data JDBC 默认生成的 SELECT 查询会因语法错误或列别名不匹配导致映射失败；需通过适配数据库方言的转义方式（如反引号或方括号）显式指定列名，确保 SQL 合法且结果集能正确绑定到 Java 属性。
当实体属性名与 sql 保留关键字（如 `order`）冲突时，spring data jdbc 默认生成的 select 查询会因语法错误或列别名不匹配导致映射失败；需通过适配数据库方言的转义方式（如反引号或方括号）显式指定列名，确保 sql 合法且结果集能正确绑定到 java 属性。
在 Spring Data JDBC 中，实体字段若与数据库保留关键字同名（例如 order、group、user 等），框架默认生成的 SQL 语句将直接使用该名称作为列别名（如 TEST_TABLE.order AS order），从而触发数据库语法错误（如 SQL Server 报错 “Incorrect syntax near the keyword 'order'”）。更隐蔽的问题是：即使通过双引号（如 @Column("\"ORDER\"")）使 SQL 语法合法，JDBC 结果集元数据中列别名仍为带引号的 "ORDER"，而 Spring Data JDBC 的映射器默认按未转义的属性名（即 order）匹配列，导致值无法绑定，最终属性保持默认值（如 int 类型为 0）。
✅ 正确解决方案是：使用符合目标数据库方言的标识符转义符号，而非通用双引号，并确保列别名与 Java 属性名逻辑一致。
✅ 推荐写法（按数据库类型选择）
-
MySQL / PostgreSQL（支持反引号或双引号）：
@Table("TEST_TABLE") @Data public class TestTableEntity { @Id private int id; @Column("`order`") // MySQL 推荐用反引号 private int order; }生成 SQL：SELECT TEST_TABLE.id AS id, TEST_TABLE.orderAS order FROM TEST_TABLE
注意：AS 后的别名仍为 order（无引号），与属性名完全匹配，映射成功。 -
SQL Server（必须使用方括号）：
@Column("[order]") private int order;生成 SQL：SELECT TEST_TABLE.id AS id, TEST_TABLE.[order] AS order FROM TEST_TABLE
方括号仅作用于列引用，AS 别名保持干净，保障反射映射。
⚠️ 为什么不推荐 @Column("\"order\"")？
双引号在多数数据库中表示标识符（如列名），但 Spring Data JDBC 在解析结果集时，会将 rs.getString("order") 视为查找别名为 order 的列——而实际返回的列别名是 "order"（含引号），导致 ResultSetMetaData 获取的列名与预期不一致，映射中断。
? 补充建议
- 避免保留字命名：优先重构属性名（如 sortOrder、displayOrder），从源头规避问题；
- 全局配置慎用：自定义 NamingStrategy 虽可统一加引号，但易破坏列别名一致性，不推荐用于保留字场景；
- 验证映射结果：启用 SQL 日志（logging.level.org.springframework.jdbc=DEBUG）确认生成的 SELECT 语句及列别名是否符合预期。
通过精准匹配数据库语法与框架映射逻辑，即可安全、可靠地处理保留关键字字段，无需修改底层行为或引入额外依赖。
