如何使用Golang实现代理模式_Golang代理模式访问控制方法

Go中代理模式核心是interface+struct组合+方法委托,通过控制访问时机在调用前后插入逻辑,典型如鉴权、日志、限流等场景,需注意初始化、空指针及上下文传递。

代理模式在 Go 中的核心实现方式

Go 本身没有 class 和继承,所以不能照搬 Java 那套“接口 + 实现类 + 代理类”三层结构。真正的 Go 风格代理,靠的是 interface + struct 组合 + 方法委托,关键在于“控制访问时机”——不是拦截方法调用,而是在调用前后插入逻辑。

典型做法是定义一个服务接口(比如 DataService),让真实对象和代理对象都实现它;代理内部持有一个真实对象的指针,在自己的方法里决定是否、何时、如何调用真实对象的对应方法。

type DataService interface {
    Get(id int) (string, error)
    Save(data string) error
}

type RealDataService struct{}

func (r *RealDataService) Get(id int) (string, error) {
    return fmt.Sprintf("data-%d", id), nil
}

func (r *RealDataService) Save(data string) error {
    fmt.Println("saving:", data)
    return nil
}

type AuthProxy struct {
    ds DataService
    token string
}

func (p *AuthProxy) Get(id int) (string, error) {
    if !p.isValidToken() {
        return "", errors.New("unauthorized")
    }
    return p.ds.Get(id)
}

func (p *AuthProxy) Save(data string) error {
    if !p.isValidToken() {
        return errors.New("unauthorized")
    }
    return p.ds.Save(data)
}

func (p *AuthProxy) isValidToken() bool {
    return p.token == "valid-token"
}

用嵌入结构体简化代理逻辑

如果代理只是加一层校验或日志,不想重复写所有方法签名,可以用结构体嵌入(embedding)把真实对象“藏”进代理里,再选择性重写需要控制的方法。Go 会自动提升嵌入字段的方法,未重写的方法直接透传。

  • 嵌入后,AuthProxy 自动获得 GetSave 方法,但只有重写的那个才生效
  • 重写方法里用 p.RealDataService.Get(id) 显式调用原方法,避免无限递归
  • 注意:嵌入的是指针类型(*RealDataService),否则无法修改底层状态
type AuthProxy struct {
    *RealDataService // 嵌入
    token string
}

func (p *AuthProxy) Get(id int) (string, error) {
    if !p.isValidToken() {
        return "", errors.New("unauthorized")
    }
    return p.RealDataService.Get(id) // 显式调用
}

代理常用于访问控制的几个典型场景

代理模式在 Go 中最实在的用途不是“设计模式炫技”,而是解决具体访问控制问题:权限校验、限流、缓存、审计日志、延迟加载。重点不是“代理存在”,而是“在哪插逻辑”。

  • 鉴权失败立即返回:如上例,在 Get 开头检查 token,不满足就直接 return,真实对象根本不会被调用
  • 操作前/后钩子:比如 Save 方法里,可以在调用真实 Save 前记录日志,调用后更新统计计数器
  • 避免暴露真实对象细节:外部只依赖 DataService 接口,完全不知道背后是内存结构、数据库连接还是 HTTP 客户端
  • 测试友好:单元测试时可轻松用 mock 代理替换真实数据服务,无需改业务代码

容易踩的坑:空指针、循环引用、接口零值

代理对象本身是结构体,如果字段没初始化就调用方法,运行时 panic 是大概率事件。尤其要注意嵌入字段和依赖对象的初始化顺序。

  • AuthProxy{ds: nil} 然后调 Get() → panic: nil pointer dereference
  • 代理构造函数必须显式传入真实对象,不能依赖包级变量或全局单例(否则难以测试且隐藏依赖)
  • 如果代理要持有一些上下文(如 context.Context 或用户信息),别塞进结构体字段,应作为方法参数传入,否则并发下易出错
  • 接口类型变量的零值是 nil,判断代理是否持有真实对象要用 p.ds != nil,而不是 p.ds == nil 的反向逻辑来兜底

代理真正难的不是写法,而是想清楚“控制点”在哪——是每次调用都鉴权,还是只在敏感操作上?token 是从 HTTP header 解析,还是从 context.Value 取?这些决策比结构体怎么嵌入重要得多。