如何在 Spring Boot 中通过单个 API 接口返回多个不同类型的数据-java教程-PHP中文网

在 spring boot 中，可通过自定义响应包装类将 list 和对象等不同结构的数据统一封装，再以 responseentity 形式返回，实现单个 get 接口响应多维度业务数据。

在 spring boot 中，可通过自定义响应包装类将 list 和对象等不同结构的数据统一封装，再以 responseentity 形式返回，实现单个 get 接口响应多维度业务数据。

在实际开发中，一个查询接口常需同时返回聚合信息（如订单详情）与关联集合（如快递员列表）。Spring Boot 默认不支持直接返回多个不相关类型的值，但可通过「响应体封装」优雅解决。核心思路是：定义一个 POJO 类作为统一响应载体，将不同数据字段纳入其中，并使用 ResponseEntity 构建结构化 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; }
}</courier></courier></courier></courier></courier>

✅ 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);
}</courier></searchresponse>

⚠️ 注意事项

若 couriers 可能为 null，建议在构造函数中做空值保护（如上例），避免前端解析时出现 NullPointerException 或 JSON 字段缺失；
返回类型明确声明为 ResponseEntity，既保证类型安全，又便于添加自定义状态码、Header 等；
不推荐使用 Map 等泛型结构替代包装类——它牺牲了可读性、可维护性与 Swagger 文档生成能力；
如需支持分页或元信息（如总条数、当前页），可进一步扩展 SearchResponse，加入 PageInfo 或通用 Meta 字段。

? 总结：单一 REST 接口返回多模型数据的关键在于「语义化封装」。通过领域驱动的响应类设计，不仅满足技术需求，更提升了 API 的一致性、可测试性与协作效率。