📚 课程目录第3章领域边界设计原则

3. 领域边界设计原则：单一职责、高内聚低耦合、限界上下文在 BFF 层的应用

BFF（Backend For Frontend）层位于前端与后端微服务之间，承担着接口聚合、数据裁剪、协议转换等职责。若缺乏清晰的领域边界设计，BFF 层极易退化为“上帝服务”——一个包含大量无关逻辑、耦合严重、难以维护的单体。本章围绕三个核心原则，阐述如何在 BFF 层构建稳固的领域边界。

3.1 单一职责原则：一个 BFF 只为一个前端面

单一职责原则（SRP）在 BFF 层的直接映射是：一个 BFF 服务只服务于一种前端客户端。移动端、桌面 Web、小程序、IoT 设备各自拥有独立的 BFF 实例，而非共享同一个 BFF。

前端类型	BFF 实例	典型职责
移动端 App	`bff-mobile`	小包体、低频轮询、离线缓存接口
桌面 Web	`bff-web`	大屏数据、实时推送、复杂表单提交
小程序	`bff-miniapp`	登录态融合、模板消息、云函数代理
IoT 设备	`bff-iot`	二进制协议转换、低带宽压缩、设备指令聚合

  实践要点： 在 Go 项目中，每个 BFF 实例应拥有独立的 cmd/ 入口、独立的 internal/ 包路径，以及独立的部署单元（Docker 镜像 / K8s Deployment）。禁止在同一个进程中通过路由前缀区分客户端类型。

3.2 高内聚低耦合：BFF 内部的模块组织

高内聚要求 BFF 内部按“业务领域”而非“技术层次”组织代码。低耦合则要求 BFF 与下游微服务之间通过明确的接口契约交互，避免直接依赖内部实现。

以下是一个符合高内聚低耦合的 Go 项目结构示例：

internal/
├── order/                # 订单领域
│   ├── handler.go        # HTTP handler（仅做参数校验与响应组装）
│   ├── service.go        # 业务编排（聚合多个下游服务）
│   ├── repository.go     # 下游服务调用接口（interface）
│   └── dto.go            # 领域传输对象
├── user/                 # 用户领域
│   ├── handler.go
│   ├── service.go
│   ├── repository.go
│   └── dto.go
└── common/               # 跨领域共享
    ├── middleware/
    ├── errors/
    └── config/

内聚性检查清单：

一个领域包内的文件是否都围绕同一个业务概念（如订单、支付、库存）？
领域包之间是否存在循环引用？
修改一个领域的需求时，是否只需要改动该领域包内的文件？

3.3 限界上下文：BFF 层的上下文边界划分

限界上下文（Bounded Context）是 DDD 中用于划定模型边界的关键模式。在 BFF 层，每个限界上下文对应一组强相关的接口集合，拥有独立的领域模型、数据转换逻辑和错误处理策略。

以下 SVG 展示了电商系统中 BFF 层的三个典型限界上下文及其与前端、后端微服务的关系：

3.4 原则融合：在 BFF 层落地限界上下文

将单一职责、高内聚低耦合与限界上下文三者融合，在 BFF 层形成以下落地策略：

按前端类型拆分 BFF 实例（单一职责）——每个实例只服务一种客户端。
按业务领域拆分 BFF 内部模块（高内聚）——每个领域包对应一个限界上下文。
通过接口隔离下游依赖（低耦合）——领域包内的 repository 层定义接口，实现由依赖注入提供。
上下文间禁止直接调用——若订单上下文需要用户信息，通过 BFF 层的编排层（Service）组合调用，而非在订单包内直接调用用户包。

常见反模式： 在 BFF 内部创建“共享领域模型”（如一个巨大的 UserDTO 被所有上下文引用），这会导致上下文边界被破坏，任何一方的变更都会波及全局。正确的做法是每个上下文定义自己的 DTO，通过适配器（Adapter）进行转换。

3.5 边界验证：通过接口契约保障

在 Go 中，限界上下文之间的边界通过 interface 和 包隔离 来保障。以下是一个典型的上下文间调用示例：

// order/service.go
type UserService interface {
    GetUserAddress(ctx context.Context, userID string) (*AddressDTO, error)
}

type OrderService struct {
    userSvc UserService
    orderRPC OrderRPCClient
}

func (s *OrderService) CreateOrder(ctx context.Context, req *CreateOrderReq) (*OrderDTO, error) {
    // 通过接口调用用户上下文，不直接依赖 user 包
    addr, err := s.userSvc.GetUserAddress(ctx, req.UserID)
    if err != nil {
        return nil, fmt.Errorf("get user address: %w", err)
    }
    // ... 业务编排
}

  边界测试策略： 为每个限界上下文编写独立的单元测试，使用 mock 替代外部依赖。集成测试时，只测试单个上下文与下游服务的交互，避免跨上下文的集成测试耦合。

通过以上原则的组合应用，BFF 层不再是“胶水代码”的堆积地，而是具备清晰领域边界的业务编排层。每个限界上下文可以独立开发、测试、部署和扩展，真正实现“高内聚、低耦合”的架构目标。