Go语言中的组合式接口设计模式

背景和需求

在微服务架构和复杂业务系统中，我们经常需要调用多个外部服务或内部模块。传统的做法是将所有方法都放在一个大接口中，但这种设计会导致接口臃肿、职责不清。今天我们来探讨一种更优雅的设计模式：组合式接口设计。

问题场景
假设我们正在开发一个电商系统，需要集成多个服务：

• 支付服务：处理支付、退款等
• 物流服务：查询物流、发货等
• 用户服务：用户信息管理
• 商品服务：商品信息管理

传统设计的问题

// 传统的混合接口设计（不推荐）
type ExternalAPI interface {// 支付相关CreatePayment(ctx context.Context, order *Order) (*Payment, error)RefundPayment(ctx context.Context, paymentID string) error// 物流相关CreateShipment(ctx context.Context, order *Order) (*Shipment, error)TrackShipment(ctx context.Context, trackingID string) (*TrackingInfo, error)// 用户相关GetUserProfile(ctx context.Context, userID string) (*User, error)UpdateUserProfile(ctx context.Context, user *User) error// 商品相关GetProductInfo(ctx context.Context, productID string) (*Product, error)UpdateProductStock(ctx context.Context, productID string, stock int) error
}

传统方式：

// 不清楚这些方法来自哪个服务
api.CreatePayment(ctx, order)
api.TrackShipment(ctx, trackingID)
api.GetUserProfile(ctx, userID)

组合式接口设计

// 主接口：服务聚合器
type ExternalAPI interface {Payment() PaymentServiceLogistics() LogisticsServiceUser() UserServiceProduct() ProductService
}// 支付服务接口
type PaymentService interface {CreatePayment(ctx context.Context, order *Order) (*Payment, error)RefundPayment(ctx context.Context, paymentID string) errorGetPaymentStatus(ctx context.Context, paymentID string) (*PaymentStatus, error)
}// 物流服务接口
type LogisticsService interface {CreateShipment(ctx context.Context, order *Order) (*Shipment, error)TrackShipment(ctx context.Context, trackingID string) (*TrackingInfo, error)CancelShipment(ctx context.Context, shipmentID string) error
}// 用户服务接口
type UserService interface {GetUserProfile(ctx context.Context, userID string) (*User, error)UpdateUserProfile(ctx context.Context, user *User) errorGetUserOrders(ctx context.Context, userID string) ([]*Order, error)
}// 商品服务接口
type ProductService interface {GetProductInfo(ctx context.Context, productID string) (*Product, error)UpdateProductStock(ctx context.Context, productID string, stock int) errorSearchProducts(ctx context.Context, query string) ([]*Product, error)
}

组合式设计：

// 清晰的服务边界和调用意图
api.Payment().CreatePayment(ctx, order)
api.Logistics().TrackShipment(ctx, trackingID)
api.User().GetUserProfile(ctx, userID)

通过这种设计，我们不仅提高了代码的可维护性，还让团队协作变得更加高效——每个开发者都能清楚地知道自己在调用哪个服务的哪个功能。

接口定义改变：从混合接口变为组合接口