在 spring boot 中，可通过自定义封装类将 list、object 等多种数据结构统一包装为一个响应体，实现单个 get 接口返回多类型数据（如订单信息与快递列表），提升接口设计的简洁性与前端调用效率。
在 spring boot 中，可通过自定义封装类将 list、object 等多种数据结构统一包装为一个响应体，实现单个 get 接口返回多类型数据（如订单信息与快递列表），提升接口设计的简洁性与前端调用效率。
在实际开发中，常遇到需在一个 REST 接口（如 /search/{id}）中同时返回关联但结构不同的数据——例如一个订单详情（Order 对象）和一组匹配的快递信息（List<Courier>）。Spring Boot 默认不支持直接返回多个独立对象，但可通过「响应聚合」方式优雅解决：定义一个专用 DTO 类，将异构数据统一封装，再以 ResponseEntity<T> 形式返回。
✅ 正确做法：封装统一响应体
首先，创建一个轻量级响应包装类（推荐使用 Lombok 简化代码）：
public class SearchResponse {
private Order order;
private List<Courier> couriers; // 注意：原问题中提到的是 List<Courier>，非单个 Courier
// 构造函数（支持空列表安全初始化）
public SearchResponse(Order order, List<Courier> couriers) {
this.order = order;
this.couriers = couriers != null ? couriers : Collections.emptyList();
}
// Getter 方法（必须，否则 JSON 序列化失败）
public Order getOrder() { return order; }
public List<Courier> getCouriers() { return couriers; }
}⚠️ 注意：问题描述中提到“List of couriers”，因此字段应为 List<Courier>，而非单个 Courier；若误用单对象会导致数据丢失或反序列化异常。
接着，在 Controller 中使用该类作为返回类型，并借助 ResponseEntity.ok() 构建标准 HTTP 200 响应：
@GetMapping("/search/{id}")
public ResponseEntity<SearchResponse> search(@PathVariable String id) {
Order order = fetchOrderById(id); // 模拟获取订单
List<Courier> couriers = fetchCouriersByOrderId(id); // 模拟获取快递列表
SearchResponse response = new SearchResponse(order, couriers);
return ResponseEntity.ok(response);
}✅ 补充建议与最佳实践
- 统一响应结构（推荐）：生产环境中建议进一步封装为通用响应格式（如包含 code、message、data 字段），便于全局异常处理与前端统一解析；
- 空值安全：始终对可能为 null 的集合做防御性初始化（如 Collections.emptyList()），避免 Jackson 序列化报错；
- DTO 而非 Entity 直出：勿直接返回 JPA 实体类，应使用专门的 DTO 避免循环引用、敏感字段泄露及序列化干扰；
- API 文档同步：配合 Springdoc OpenAPI（Swagger），为 SearchResponse 自动生成清晰的接口文档。
通过这一模式，不仅满足了单接口多数据返回的需求，还保持了 RESTful 设计原则与前后端协作的健壮性。
