微服务中多个接口聚合需解决可复用性、并发安全与超时控制三大问题：一是用 sync.WaitGroup 正确收集结果并传播错误；二是按 key 实现请求合并（Request Coalescing）避免重复调用；三是网关层通过 Facade 模式统一超时、降级与字段映射。
微服务里“多个接口要一起返回”不是加几个 go 就完事的，关键在聚合逻辑是否可复用、是否抗并发、是否带超时控制——直接拼 sync.WaitGroup 容易漏错误处理，硬套 sync.Once 又没法按 key 分流，真正要解决的是「相同请求不重复发」和「不同请求并行发但结果统一收」这两件事。
如何用 sync.WaitGroup 安全聚合多个 HTTP 请求
这是最常用也最容易出错的场景：5 个下游服务都要调，等全回来再组装响应。核心不是并发本身，而是结果收集与错误传播。
-
wg.Add(1)必须在go语句之前调用，且总数必须等于实际启动的 goroutine 数；漏加或加多都会导致wg.Wait()永久阻塞或提前返回 - 结果写入建议预分配切片：
results := make([]*http.Response, len(urls))，然后用索引赋值（results[i] = resp），避免append引发的并发 panic - 每个 goroutine 必须用
defer resp.Body.Close()，否则连接池耗尽；别把resp.Body直接存进共享结构，它是一次性 reader - 所有请求必须共用同一个
context.Context（来自context.WithTimeout），否则某个请求超时不会触发其余请求取消
怎么避免对同一资源的重复请求（Request Coalescing）
当多个并发请求都查 /user/123，而缓存未命中时，不该让 10 个 goroutine 全去查 DB 或远程服务——得让它们排队，只执行一次后广播结果。
- 不要用全局
sync.Mutex锁住整个 map，那是性能瓶颈；应该按 key 分片，每个 key 对应一个独立协调单元 - 推荐用
sync.Map存储*requestGroup，其中requestGroup内部用chan实现等待队列 + 结果广播 -
sync.Once只适合单次初始化，不适合动态 key 场景；它的Do方法无法传参，也不支持等待返回值 - 注意清理机制：长期运行的服务需定期清理空闲的
requestGroup，否则内存泄漏；可结合time.AfterFunc或 LRU 策略
API 网关层如何做跨服务响应合并（Facade 模式）
前端一个请求要拉用户信息、订单列表、积分余额，网关不能简单转发三次再拼，得控制整体超时、失败降级、字段映射。
立即学习“go语言免费学习笔记（深入）”；
- 别在 handler 里手写三个
http.Get—— 应该封装成独立 service 接口，比如UserClient.GetUser()、OrderClient.ListByUserID()，便于 mock 和测试 - 聚合逻辑要拆离路由层，放到单独的
Aggregatorstruct 中，它接收 context、userID，返回组合后的 DTO，不耦合 HTTP 细节 - 某一个下游失败时，是否允许部分返回？需要明确策略：
return partial if user ok but order timeout还是fail fast；这直接影响前端体验和重试设计 - 字段命名冲突常见（比如两个服务都返回
id字段），聚合前必须做命名空间隔离或重映射，否则 JSON 序列化会覆盖
go-zero 的 api 文件如何定义聚合接口
如果你用 go-zero，.api 文件本身不支持直接声明“这个接口要调三个下游”，但可以通过 @handler 绑定自定义 logic 实现聚合。
- 在
user.api里定义聚合 endpoint：@handler getUserWithOrders get /api/users/:id/with-orders - 生成的
getUserWithOrdersLogic里，手动调用u.svcCtx.UserModel.FindOne、u.svcCtx.OrderModel.FindAllByUserID等，而非硬编码 HTTP 调用 - go-zero 默认不校验下游返回，你得自己判断
err != nil或resp == nil，并在 logic 层统一包装错误码（如http.StatusBadGateway） - 注意
svcCtx中注入的 client 是否带 context 超时；如果没设，默认走框架全局 timeout，可能和你业务期望不符
真正难的不是并发或合并语法，而是决定哪些请求该合、哪些该分——相同 key 的查缓存必须合并，不同业务域的数据聚合必须保留失败隔离能力，而网关层的字段拼接一旦上线就很难改。这些决策比代码多两行更影响系统寿命。
