go微服务中需自写bff而非仅用反向代理，因其需实现跨服务数据聚合、字段裁剪、权限透传、错误码归一化等业务语义逻辑，核心是面向前端的协调与控制，而非简单转发。
为什么 Go 微服务里要自己写 BFF，而不是直接用反向代理？
因为反向代理（比如 Nginx）没法做跨服务的数据组装、字段裁剪、权限上下文透传、错误码归一化这些事——它只管转发，而 BFF 的核心职责是「面向前端的业务语义聚合」。
外观模式在这里不是为了“解耦”，而是为了把 UserService.GetProfile()、OrderService.ListRecent()、NotificationService.UnreadCount() 这些异构调用，封装成一个干净的 DashboardAPI.GetHomeData() 接口。关键不在结构设计，而在控制权：你得能决定超时怎么设、失败怎么降级、缓存键怎么拼。
- 别用
http.DefaultClient直接发请求——它没超时、没连接池复用，压测时容易瞬间打崩下游或自己 OOM - 别在 BFF 层做复杂计算或写 DB——它不是业务服务，只是协调者；一旦开始查表、加减乘除、生成 PDF，就违背了 BFF 的轻量定位
- 前端传来的
user_id别直接透传给下游——要先过AuthMiddleware解析 JWT，提取sub做校验，再构造带X-Request-ID和X-User-ID的 context 传下去
Go 中实现外观层时，sync.WaitGroup 和 errgroup.Group 怎么选？
两者都能并发调用多个下游，但行为差异极大：sync.WaitGroup 不管错误，所有 goroutine 都会跑完；errgroup.Group 默认遇到第一个 error 就 cancel 其余任务，更符合 BFF 的 fail-fast 场景。
实际用法上，errgroup.Group 更省心，尤其当你需要统一超时、取消和错误收集时：
立即学习“go语言免费学习笔记（深入）”；
g, ctx := errgroup.WithContext(r.Context())
var profile *UserProfile
var orders []Order
var notifCount int
g.Go(func() error {
var err error
profile, err = userClient.Get(ctx, userID)
return err
})
g.Go(func() error {
var err error
orders, err = orderClient.List(ctx, userID, 5)
return err
})
g.Go(func() error {
var err error
notifCount, err = notifyClient.Count(ctx, userID)
return err
})
if err := g.Wait(); err != nil {
http.Error(w, "service unavailable", http.StatusServiceUnavailable)
return
}
- 用
errgroup.WithContext()而不是裸context.Background()——BFF 必须继承上游 HTTP 请求的生命周期，否则超时/取消信号传不下去 - 别在 goroutine 里直接操作响应 writer（
w.Write()）——并发写会 panic；所有数据必须先 gather 再统一序列化 -
sync.WaitGroup只适合「全都要，错也得等」的场景，比如日志上报、埋点采集这类非关键路径
JSON 字段嵌套太深、命名不一致，怎么避免手动 map？
前端要 user.name，下游返回的是 {"full_name": "Alice", "status_code": 1}，硬写 struct tag 或手动赋值极易出错且难维护。Go 没有反射式动态映射，但可以用组合方式解耦：
- 定义 BFF 层专属 DTO，比如
type HomeResponse struct { UserName string `json:"user_name"` }，然后用mapstructure.Decode()做字段映射——比手写res.UserName = upstream.FullName更安全 - 别依赖下游的 JSON key 名——用
json:"-"显式忽略未知字段，防止新增字段导致解析失败；同时开启Decoder.DisallowUnknownFields()在开发期暴露结构不匹配问题 - 对敏感字段（如
email、phone）做运行时脱敏，不要靠前端 JS 处理——BFF 是最后一道可控防线
本地调试 BFF 时，为什么总连不上本地启动的 gRPC 服务？
常见原因是 gRPC 客户端默认用 dns:/// 解析，而本地服务通常监听 localhost:9000，DNS 解析失败后 fallback 到直连又可能被防火墙拦截。最稳的方式是绕过 resolver，直连 IP+端口：
conn, err := grpc.Dial("127.0.0.1:9000",
grpc.WithTransportCredentials(insecure.NewCredentials()),
grpc.WithBlock(), // 同步阻塞直到连上，方便调试
)
- 别在生产环境用
insecure.NewCredentials()——BFF 和下游之间必须走 TLS，哪怕自签证书也要配好grpc.WithTransportCredentials(credentials.NewTLS(...)) - 本地启多个服务时，端口冲突很常见；建议用
go run main.go -user-port=9001 -order-port=9002这类 flag 控制，而不是写死在代码里 - 用
grpcurl -plaintext localhost:9000 list快速验证服务是否真正 ready，比 curl 更准——HTTP 健康检查通过 ≠ gRPC server 已加载 service
BFF 层最难的从来不是并发或路由，而是状态管理：你得清楚每个字段来自哪个服务、缓存 TTL 是多少、降级逻辑是否覆盖了所有网络异常分支。这些细节不会报错，但会在大促时悄悄拖垮成功率。
