在 spring boot 中，可通过自定义响应包装类将 list 和对象等不同结构的数据统一封装，再以 responseentity 形式返回，实现单个 get 接口响应多维度业务数据。
在 spring boot 中，可通过自定义响应包装类将 list 和对象等不同结构的数据统一封装，再以 responseentity 形式返回，实现单个 get 接口响应多维度业务数据。
在实际开发中，一个查询接口常需同时返回聚合信息（如订单详情）与关联集合（如快递员列表）。Spring Boot 默认不支持直接返回多个不相关类型的值，但可通过「响应体封装」优雅解决。核心思路是：定义一个 POJO 类作为统一响应载体，将不同数据字段纳入其中，并使用 ResponseEntity<T> 构建结构化 HTTP 响应。
以下为完整实现步骤：
✅ 1. 定义响应包装类（推荐使用 Lombok 简化代码）
public class SearchResponse {
private OrderRelatedInfo order;
private List<Courier> couriers; // 注意：原问题中提到的是 List<Courier>，非单个 Courier
// 构造函数（支持空列表安全初始化）
public SearchResponse(OrderRelatedInfo order, List<Courier> couriers) {
this.order = order;
this.couriers = Objects.requireNonNullElse(couriers, Collections.emptyList());
}
// Getter & Setter（或使用 @Data 注解）
public OrderRelatedInfo getOrder() { return order; }
public void setOrder(OrderRelatedInfo order) { this.order = order; }
public List<Courier> getCouriers() { return couriers; }
public void setCouriers(List<Courier> couriers) { this.couriers = couriers; }
}✅ 2. 在 Controller 中使用该类作为返回类型
@GetMapping("/search/{id}")
public ResponseEntity<SearchResponse> search(@PathVariable String id) {
// 模拟业务逻辑：获取订单与快递员列表
OrderRelatedInfo order = orderService.findById(id);
List<Courier> couriers = courierService.findByOrderId(id);
// 统一封装并返回 200 OK 响应
SearchResponse response = new SearchResponse(order, couriers);
return ResponseEntity.ok(response);
}⚠️ 注意事项
- 若 couriers 可能为 null，建议在构造函数中做空值保护（如上例），避免前端解析时出现 NullPointerException 或 JSON 字段缺失；
- 返回类型明确声明为 ResponseEntity<SearchResponse>，既保证类型安全，又便于添加自定义状态码、Header 等；
- 不推荐使用 Map<String, Object> 等泛型结构替代包装类——它牺牲了可读性、可维护性与 Swagger 文档生成能力；
- 如需支持分页或元信息（如总条数、当前页），可进一步扩展 SearchResponse，加入 PageInfo 或通用 Meta 字段。
? 总结：单一 REST 接口返回多模型数据的关键在于「语义化封装」。通过领域驱动的响应类设计，不仅满足技术需求，更提升了 API 的一致性、可测试性与协作效率。
