Spring Boot+Hibernate环境下提交请求后外键字段为何为空？

核心原因 #

你的请求体传递的是user_id和product_id数值字段，但UserOrder实体类中对应的是User user和Product product实体对象。Spring默认的消息转换器无法自动将纯ID值转换为JPA实体对象，导致这两个字段为null，最终数据库外键字段为空。

另外，Product实体中@OneToOne(mappedBy = "product",cascade = CascadeType.ALL)的cascade = CascadeType.ALL配置不合理：当你尝试关联已有商品时，级联操作会让Hibernate误以为要新建Product，而非关联现有ID的对象，进一步加剧问题。

解决方案 #

1. 使用DTO接收请求参数，手动关联实体（推荐方案） #

创建一个专门的请求DTO类来接收前端参数，避免直接用实体类接收：

@Data
public class UserOrderRequest {
    private Integer userId;
    private Integer productId;
    private String quantity;
}

在控制器中，先通过ID从数据库查询出对应的User和Product，再组装成UserOrder对象保存：

@PostMapping("/orders")
public ResponseEntity<UserOrder> createOrder(@RequestBody UserOrderRequest request) {
    User user = userRepository.findById(request.getUserId())
            .orElseThrow(() -> new IllegalArgumentException("用户不存在"));
    Product product = productRepository.findById(request.getProductId())
            .orElseThrow(() -> new IllegalArgumentException("商品不存在"));

    UserOrder order = UserOrder.builder()
            .quantity(request.getQuantity())
            .user(user)
            .product(product)
            .build();

    return ResponseEntity.ok(orderRepository.save(order));
}

2. 修正实体类的关联配置 #

移除Product实体中@OneToOne的级联配置，因为订单关联已有商品时不需要级联操作商品：

@Entity
@Table
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Product {
    // ... 其他字段不变
    @OneToOne(mappedBy = "product")
    private UserOrder userOrder;
}

关于@JoinColumn(nullable = false)的异常 #

设置该约束触发异常的本质是user/product字段为null，违反了非空约束。解决上述问题后，这个配置就能正常生效，强制订单必须关联用户和商品。

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