Kratos 的 errgroup.Group 仅支持并发控制与错误传播,无法实现请求合并;真正的合并需业务层显式设计批量接口或在客户端/网关层做缓冲聚合。

Kratos 框架本身不提供“请求合并”(request batching/merging)能力,它只负责并发协调与错误传播;真正的合并必须由业务层显式设计——要么在 BFF 接口里把多个 ID 打包成一个 GetItemsRequest,要么在客户端或网关层做缓冲聚合。
为什么 Kratos 的 errgroup.Group 不能直接做请求合并
Kratos 的 errgroup.Group 是并发控制结构,不是请求调度器。它只解决「多个 goroutine 同时发请求、谁先出错谁终止其余」的问题,但每个 goroutine 仍对应一次独立的 gRPC/HTTP 调用。如果你传入 10 个 GetUserByID 请求,它会并发发起 10 次调用,而不是合并成 1 次 GetUsersByID。
- 常见误用:用
errgroup.WithContext(ctx)包裹 100 个client.GetUser(ctx, &pb.GetUserReq{ID: id})—— 这是并发,不是合并 - 真正合并的前提:下游服务必须提供批量接口,例如
GetUsers(ctx, &pb.GetUsersReq{IDs: []int64{1,2,3}}) - 若下游只有单条接口,强行在 BFF 层“模拟合并”(如用 map 缓存 + 定时 flush)会引入状态、超时不一致、goroutine 泄漏等风险
在 BFF 层实现批量聚合的典型写法
假设你有「商品详情页」需要查商品、库存、促销三个服务,且每个服务都支持批量接口,那么聚合逻辑应长这样:
// 1. 先收集成批 ID(来自前端 query 或 body)
ids := r.URL.Query()["item_id"] // 或从 JSON body 解出 []string
// 2. 构造批量请求
itemReq := &itemspb.GetItemsReq{IDs: ids}
stockReq := &stockspb.GetStocksReq{ItemIDs: ids}
promoReq := &promospb.GetPromosReq{ItemIDs: ids}
// 3. 并发调用,用 errgroup 协同取消
g, ctx := errgroup.WithContext(r.Context())
var itemsResp *itemspb.GetItemsResp
var stockResp *stockspb.GetStocksResp
var promoResp *promospb.GetPromosResp
g.Go(func() error {
var err error
itemsResp, err = itemClient.GetItems(ctx, itemReq)
return err
})
g.Go(func() error {
var err error
stockResp, err = stockClient.GetStocks(ctx, stockReq)
return err
})
g.Go(func() error {
var err error
promoResp, err = promoClient.GetPromos(ctx, promoReq)
return err
})
if err := g.Wait(); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
// 4. 合并结果(按 ID 对齐、补空、降级)
data := make(map[string]map[string]interface{})
for _, item := range itemsResp.Items {
data[item.ID] = map[string]interface{}{"item": item}
}
// ... 同理填充 stock、promo,再 merge 到同一 map
- 关键点:所有子请求共用同一个
ctx,超时由外层统一控制;Wait()只返回第一个非 nil 错误 - 如果某个服务不支持批量(比如只有
GetUserByID),你必须自己封装一个批量适配器,或接受串行 fallback - 注意字段对齐逻辑——不同服务返回的 ID 格式可能不一致(字符串 vs int64),需提前 normalize
客户端或网关层做请求合并的边界在哪
真正意义上的「请求合并」(即 N 个前端请求 → 1 个后端请求)不在 Kratos 应用层发生,而应在更前置的位置:
- Fregata 网关:可配置路由规则,将 /api/items/{id1},{id2} 重写为 /api/items/batch?ids=id1,id2,再转发给 BFF
- 前端 SDK:在调用
getItem(id)时,先塞进本地 buffer,200ms 内有新请求就合并,超时则发getItems([id1,id2,...]) - BFF 自建合并队列(慎用):仅适用于低 QPS、强一致性要求不高、且能容忍 ~200ms 延迟的场景;需用
ConcurrentLinkedQueue+ 定时器 +CompletableFuture-类机制,但 Kratos 生态无现成封装,易出 bug
最常被忽略的是:合并后的响应分发必须保持原始请求的语义。比如用户 A 请求 item-1、用户 B 请求 item-2,合并后拿到 {item-1: ..., item-2: ...},不能把 item-2 的数据错发给用户 A。


















