JPA 插入数据时 active 列重复问题解析与解决方案

2024-11-12 01:39:23

JPA 插入数据时列重复问题解析与解决方案

在使用 JPA 进行数据插入操作时，有时会遇到列重复的问题，尤其是在主键和外键同时包含多个列的情况下。本文将针对 "JPA 插入时重复 active 列" 这个问题，深入分析其产生的原因，并提供有效的解决方案。错误信息通常类似于：could not execute statement [No value specified for parameter 6.] ...，这表明 JPA 生成了错误的 SQL 语句，导致参数绑定失败。

问题分析：复合主键与复合外键的冲突

这个问题的核心在于复合主键和复合外键的定义与 JPA 的映射方式存在冲突。当表 payment_item 的主键和外键都包含 id 和 active 两列时，JPA 在生成 INSERT 语句时，会将 active 列重复写入，从而导致参数数量不匹配，数据库报错。

数据库认为 payment_item 表需要插入 id, payment_id, active, active 四个值 (其中 active 重复出现)，而实体类 PaymentItemEntity 只提供了三个值，从而引发了 "No value specified for parameter" 的错误。

解决方案一：调整实体映射

一种解决方法是调整实体映射关系，避免 active 列在 INSERT 语句中重复出现。由于 active 已经在复合主键中声明，在 @ManyToOne 的 @JoinColumns 注解中可以省略对 active 的引用。JPA 会自动识别并使用主键中的 active 值进行关联。

代码示例:

@Entity
@Table(name = "payment_item")
@IdClass(PaymentItemKey.class)
public class PaymentItemEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "payment_item_generator")
    @SequenceGenerator(name = "payment_item_generator", sequenceName = "payment_item_seq", allocationSize = 1)
    private Long id;

    @Id
    private boolean active = true;

    @ManyToOne
    @JoinColumn(name = "payment_id", referencedColumnName = "id")
    private PaymentEntity payment;

}

操作步骤:

修改 PaymentItemEntity 类，移除 @JoinColumns 注解中对 active 列的引用。
重新编译并运行应用程序。

解决方案二：使用 `@DiscriminatorColumn` 进行分区

如果需要使用 active 列进行分区，但又不想将其作为主键的一部分，可以使用 @DiscriminatorColumn 注解。这允许您根据 active 的值将数据逻辑上划分，而无需将其包含在主键中。这将避免与外键的冲突。

代码示例:

@Entity
@Table(name = "payment_item")
@DiscriminatorColumn(name = "active", discriminatorType = DiscriminatorType.INTEGER) // 将 active 作为区分列
public class PaymentItemEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "payment_item_generator")
    @SequenceGenerator(name = "payment_item_generator", sequenceName = "payment_item_seq", allocationSize = 1)
    private Long id;

    //  移除 active 作为 @Id
    private boolean active = true;


    @ManyToOne
    @JoinColumn(name = "payment_id", referencedColumnName = "id")
    private PaymentEntity payment;

}

DDL 修改： 移除 active 从主键定义中。

CREATE TABLE payment_item (
    id BIGINT PRIMARY KEY,
    payment_id BIGINT NOT NULL,
    active BOOLEAN NOT NULL DEFAULT true,
    FOREIGN KEY (payment_id) REFERENCES payment(id)
) PARTITION BY LIST (active);