Golang实现多支付网关策略模式

本文深入探讨了如何在 Go 语言中通过策略模式优雅实现多支付网关（如支付宝、微信支付、Stripe）的统一适配，强调以接口（而非 struct 组合）为核心契约进行解耦，强制方法签名包含 context.Context 实现超时与链路追踪可控，采用工厂函数按需创建可配置、可动态切换的网关实例，并在各实现中统一映射底层 SDK 差异化错误为有限、可判别的业务错误类型——既规避了硬编码依赖和抽象泄漏，又大幅提升系统的可扩展性、可测试性与生产可观测性，是构建高可用支付中间层的 Go 实践范本。

支付网关接口设计必须用 interface，别写 struct 组合

策略模式在 Go 里不是靠继承，而是靠显式接口契约。如果你定义一个 PaymentGateway 接口，所有网关（如 AlipayGateway、WechatPayGateway、StripeGateway）都实现它，调用方就只依赖这个接口，不感知具体实现。

常见错误是让上层逻辑直接持有某个具体网关的 struct 字段，比如：type OrderService struct { alipay *AlipayGateway }——这等于把策略“写死”了，后续加 PayPal 就得改结构体、改初始化逻辑、改所有调用点。

• 接口方法名要聚焦行为，例如 Charge(ctx context.Context, req *ChargeRequest) (*ChargeResponse, error)，别叫 DoAlipayCharge
• 接口方法参数尽量通用，避免为某个网关塞专属字段；差异化配置走构造函数或 WithXXX() 选项函数
• 不要在接口里暴露底层 SDK 的类型（如 *alipay.Client），否则会污染抽象边界

网关实例创建要延迟且可配置，别在 init 或全局变量里 new

不同环境（开发/沙箱/生产）对应不同网关配置，甚至同一服务在处理 B2B 和 C2C 订单时要走不同通道。硬编码实例会导致无法动态切换，也难以单元测试。

正确做法是把网关构造逻辑封装成工厂函数，接收配置并返回接口实例：

func NewAlipayGateway(conf AlipayConfig) PaymentGateway {
    return &alipayImpl{
        client: alipay.NewClient(conf.AppID, conf.PrivateKey, conf.PublicKey),
        timeout: conf.Timeout,
    }
}

• 配置结构体（如 AlipayConfig）应只含必要字段，避免和 SDK 原生 config 强耦合
• 工厂函数不负责管理生命周期；连接池、重试器等应由具体实现内部按需初始化
• 如果需要运行时选网关，可用 map[string]PaymentGateway 缓存已创建实例，key 用配置标识（如 "alipay-sandbox"）

错误处理必须统一包装，别直接透传 SDK 的 error

各支付 SDK 报错风格差异极大：支付宝可能返回 JSON 错误码 {"code":"40004","msg":"Business Failed"}，Stripe 返回 HTTP 402 + error.code = "card_declined"，微信可能只是 string 包含“签名错误”。如果上层直接 switch 错误字符串或类型，策略一换就得重写错误分支。

解决方案是在每个网关实现里做错误映射，转成你自己的业务错误类型：

func (a *alipayImpl) Charge(...) (*ChargeResponse, error) {
    resp, err := a.client.Charge(...)
    if err != nil {
        return nil, ErrPaymentNetwork
    }
    if resp.Code != "10000" {
        return nil, mapAlipayCodeToBizErr(resp.Code)
    }
    // ...
}

• 定义一组有限的业务错误常量，如 ErrPaymentNetwork、ErrPaymentDeclined、ErrPaymentInvalidAmount
• 别用 errors.Wrap 包裹原始 error 后直接返回——下游仍要解析底层细节
• 日志里可以记录原始 error，但对外暴露的 error 必须可判断、可分类

上下文传递和超时控制必须由策略外层统一注入

每个网关实现不应自己调 time.Sleep 或硬写 context.WithTimeout(context.Background(), 5*time.Second)。超时时间、trace ID、用户语言偏好等上下文信息，应该由调用方通过 context.Context 传入，并在所有网关方法签名中强制体现。

• 所有策略方法第一个参数必须是 ctx context.Context，这是 Go 生态的事实标准
• 网关内部发起 HTTP 请求时，必须用 ctx 构造带超时的 client，而不是用固定 timeout
• 如果某个网关 SDK 不支持 context（如老版本 alipay-go），需自行包装一层，用 select + done 通道做 cancel 检测

最易被忽略的是 trace propagation：你在 HTTP header 里塞了 X-Request-ID，但网关实现没把它透传给下游 SDK 的请求头，整个链路就断了。这事得在每个网关的请求构造阶段手动补全。

今天关于《Golang实现多支付网关策略模式》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！