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自动获得Get和Save方法，但只有重写的那个才生效 - 重写方法里用
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 中最实在的用途不是“设计模式炫技”，而是解决具体访问控制问题：权限校验、限流、缓存、审计日志、延迟加载。重点不是“代理存在”，而是“在哪插逻辑”。
立即学习“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 取？这些决策比结构体怎么嵌入重要得多。
