Spring Boot中带额外字段的@ManyToMany关联插入数据失败问题

核心问题 #

你创建ProductAttribute时未初始化复合主键ProductAttributeKey实例，JPA需要这个主键来唯一标识实体，否则无法完成持久化操作，导致save方法无法写入数据。

修复步骤 #

1. 完善ProductAttribute的创建逻辑 #

在Service方法中，必须先创建并设置ProductAttributeKey，再关联Product和Attribute：

@Transactional
public ProductAttribute createProductAttribute(CreateProductAttributeModel createProductAttributeModel) {
    Product product = productRepository.findById(createProductAttributeModel.getProductId())
            .orElseThrow(() -> new EntityNotFoundException("Product with id " + createProductAttributeModel.getProductId() + " not found!"));
    Attribute attribute = attributeRepository.findById(createProductAttributeModel.getAttributeId())
            .orElseThrow(() -> new EntityNotFoundException("Attribute with id " + createProductAttributeModel.getAttributeId() + " not found!"));
    String value = createProductAttributeModel.getValue();

    // 创建复合主键实例
    ProductAttributeKey attributeKey = new ProductAttributeKey();
    attributeKey.setProductId(product.getId());
    attributeKey.setAttributeId(attribute.getId());

    // 初始化ProductAttribute并设置所有字段
    ProductAttribute productAttribute = new ProductAttribute();
    productAttribute.setId(attributeKey);
    productAttribute.setProduct(product);
    productAttribute.setAttribute(attribute);
    productAttribute.setValue(value);

    return productAttributeRepository.save(productAttribute);
}

2. 可选：添加构造方法简化创建 #

在ProductAttribute实体中添加带参构造方法，避免重复代码：

@Entity
@Table(name = "product_attribute")
@Data
@AllArgsConstructor // 保留全参构造
@NoArgsConstructor  // 保留无参构造（JPA需要）
public class ProductAttribute {
    @EmbeddedId
    private ProductAttributeKey id;

    @ManyToOne
    @MapsId("productId")
    private Product product;

    @ManyToOne
    @MapsId("attributeId")
    private Attribute attribute;

    @Column
    String value;

    // 新增快捷构造方法
    public ProductAttribute(Product product, Attribute attribute, String value) {
        this.id = new ProductAttributeKey(product.getId(), attribute.getId());
        this.product = product;
        this.attribute = attribute;
        this.value = value;
    }
}

之后Service中可以直接用构造方法创建：

ProductAttribute productAttribute = new ProductAttribute(product, attribute, value);
return productAttributeRepository.save(productAttribute);

3. 验证Repository定义 #

确保ProductAttributeRepository的泛型参数正确，主键类型为ProductAttributeKey：

public interface ProductAttributeRepository extends JpaRepository<ProductAttribute, ProductAttributeKey> {
}

额外说明 #

• @MapsId注解是用来将关联实体的ID映射到复合主键的对应字段，但它不会自动创建ProductAttributeKey实例，必须手动初始化。
• 复合主键类ProductAttributeKey必须实现Serializable，你已经做到了，这是JPA的强制要求。

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