Spring环境下JPA共享主键实现及ORDER表SQL语法错误咨询

你遇到的SQL语法错误和共享主键的JPA映射逻辑无关，核心触发原因是：ORDER是所有主流关系型数据库（MySQL、H2、PostgreSQL、Oracle等）的SQL保留关键字，无特殊包裹的情况下，数据库SQL解析器会把ORDER识别为语法中排序子句ORDER BY的组成部分，无法将其解析为合法表标识符，最终抛出42001类语法错误，和报错提示“期望标识符”的描述完全匹配。
很多人遇到这个问题会反复调整@MapsId、@OneToOne的配置，本质上都是无效排查，根本没触达问题核心。

1. 解决表名保留字冲突 #

根据你的数据库类型，对Order实体的表名做合规处理，两种可选实现：

• 推荐方案：直接给Order实体指定非保留字的表名，通过@Table注解显式声明，避免后续所有SQL语句的关键字转义麻烦

  @Entity
  @Data
  @Table(name = "t_order") // 替换为非保留字的表名即可
  public class Order {
    @Id
    @Column(name = "order_id")
    private String id;
  }
  

• 兼容方案：如果必须保留order作为表名，需要用对应数据库支持的标识符包裹符将表名包裹，让解析器将其识别为普通标识符：
  • MySQL 环境：用反引号包裹，即@Table(name = "order")
  • PostgreSQL、H2 环境：用双引号包裹，即@Table(name = "\"order\"")
  • Oracle 环境：用双引号包裹大写表名，即@Table(name = "\"ORDER\"")

2. 优化共享主键的映射严谨性 #

你当前的@MapsId写法整体符合JPA共享主键的设计规范，只需要补充主键列的显式映射，避免后续字段名调整带来的映射错位：

@Entity
@Data
public class Delivery {
  @Id
  @Column(name = "order_id") // 显式声明主键列名，和关联列对齐
  private String id;

  @MapsId // 自动将关联Order的主键值，填充到当前实体的id主键字段上
  @OneToOne
  @JoinColumn(name = "order_id") // 关联列和主键列同名，完全匹配共享主键的表结构设计
  private Order order;

  private String name;
}

保持你现有的测试代码逻辑执行插入即可，不需要额外调整：

• 构造Order实例并设置主键id，调用orderRepository.save(order)完成订单记录插入
• 构造Delivery实例并设置关联的Order对象，调用deliveryRepository.save(delivery)时，JPA会自动通过@MapsId把关联Order的id填充到Delivery的主键上，不需要手动给Delivery的id赋值，即可完成共享主键的关联插入。

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