Spring Boot POST请求如何用ID代替完整实体作为请求参数？

我创建了一个带有POST方法的Spring Boot REST服务，代码如下：

@PostMapping("/")
public ResponseEntity<Order> createOrder(@RequestBody Order order) {

Order实体定义如下：

@Getter
@Setter
@Entity
@Table(name = "order")
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(columnDefinition = "serial")
    private long id;
    @ManyToOne
    @JoinColumn(name="destination")
    private Address destination;
    private String receiverLastName;
    private String receiverPhone;
    private float weight;
    private int height;
    private int length;
    private int width;
    private String description;
    @Enumerated(EnumType.STRING)
    private Status status;
    @ManyToOne
    @JoinColumn(name="courier")
    private User courier;
    @ManyToOne
    @JoinColumn(name="customer")
    private User customer;
}

当我尝试提交如下扁平JSON时，收到了Bad Request错误：

{
    "destination":1,
    "receiverLastName": "Nieman",
    "receiverPhone": "+1145127789",
    "weight": 3.25,
    "height": 75,
    "length": 15,
    "width": 20,
    "description": "very fragile",
    "status": "CREATED",
    "courier":2,
    "customer":3
}

目前我必须传入完整的实体对象（例如传入完整的Address对象而非仅ID），请问是否可以使用仅含关联ID的扁平JSON来替代完整实体传参？

当然可以，有几种常用方案解决这个问题，按推荐程度排序：

1. 使用DTO（数据传输对象）【最推荐】 #

这种方法将请求参数和数据库实体解耦，不仅能解决关联ID的问题，还能避免暴露实体的敏感字段或不必要字段给前端。

首先创建一个OrderCreateDTO类，专门用于接收创建订单的请求参数：

@Getter
@Setter
public class OrderCreateDTO {
    private Long destination;
    private String receiverLastName;
    private String receiverPhone;
    private float weight;
    private int height;
    private int length;
    private int width;
    private String description;
    private Status status;
    private Long courier;
    private Long customer;
}

然后修改Controller，接收DTO并转换为实体：

@PostMapping("/")
public ResponseEntity<Order> createOrder(@RequestBody OrderCreateDTO orderDto) {
    // 从数据库查询关联实体，不存在则抛出异常
    Address destination = addressRepository.findById(orderDto.getDestination())
            .orElseThrow(() -> new RuntimeException("指定的地址不存在"));
    User courier = userRepository.findById(orderDto.getCourier())
            .orElseThrow(() -> new RuntimeException("指定的快递员不存在"));
    User customer = userRepository.findById(orderDto.getCustomer())
            .orElseThrow(() -> new RuntimeException("指定的客户不存在"));

    // 将DTO字段映射到实体
    Order order = new Order();
    order.setDestination(destination);
    order.setCourier(courier);
    order.setCustomer(customer);
    order.setReceiverLastName(orderDto.getReceiverLastName());
    order.setReceiverPhone(orderDto.getReceiverPhone());
    order.setWeight(orderDto.getWeight());
    order.setHeight(orderDto.getHeight());
    order.setLength(orderDto.getLength());
    order.setWidth(orderDto.getWidth());
    order.setDescription(orderDto.getDescription());
    order.setStatus(orderDto.getStatus());

    // 保存并返回结果
    Order savedOrder = orderRepository.save(order);
    return ResponseEntity.ok(savedOrder);
}

2. 自定义Jackson反序列化器 #

如果不想用DTO，可以通过自定义反序列化器，让Jackson自动将JSON中的ID转换为对应的实体对象。

以Address类为例，创建反序列化器：

@Component
public class AddressDeserializer extends JsonDeserializer<Address> {
    private final AddressRepository addressRepository;

    // 通过构造注入Repository
    public AddressDeserializer(AddressRepository addressRepository) {
        this.addressRepository = addressRepository;
    }

    @Override
    public Address deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        Long addressId = p.getLongValue();
        return addressRepository.findById(addressId)
                .orElseThrow(() -> new IOException("ID为" + addressId + "的地址不存在"));
    }
}

然后在Order实体的destination字段上添加@JsonDeserialize注解指定反序列化器：

@ManyToOne
@JoinColumn(name="destination")
@JsonDeserialize(using = AddressDeserializer.class)
private Address destination;

用同样的方式为User类创建反序列化器，然后加到courier和customer字段上。这样前端传入的ID就能自动转换为实体对象，无需修改Controller代码。

3. 直接设置关联实体的ID（不推荐） #

可以通过修改实体的setter方法，直接接收ID并创建一个仅含ID的实体对象（或JPA代理对象），但这种方法存在懒加载风险，后续访问实体其他字段可能抛出异常。

修改Order实体的setter：

@Autowired
private EntityManager entityManager;

public void setDestination(Long destinationId) {
    if (destinationId != null) {
        // 使用EntityManager获取实体代理，避免查询数据库
        this.destination = entityManager.getReference(Address.class, destinationId);
    }
}

// 同理为courier和customer添加类似的setter
public void setCourier(Long courierId) {
    if (courierId != null) {
        this.courier = entityManager.getReference(User.class, courierId);
    }
}

public void setCustomer(Long customerId) {
    if (customerId != null) {
        this.customer = entityManager.getReference(User.class, customerId);
    }
}

注意：这种方法需要在事务环境下使用，否则后续访问关联实体的非ID字段会触发懒加载异常。

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