如何使用Golang实现代理模式_Go代理模式应用示例_技术教程

Go代理模式通过组合+接口嵌入+显式委托实现，而非继承；需定义小而专注的接口（如FileReader），真实对象与代理对象均实现该接口，代理通过显式字段持有真实对象并手动委托调用。

Go 语言本身没有类和继承，所以代理模式不是靠“继承接口+重写方法”来实现的，而是通过组合 + 接口嵌入 + 显式委托完成的。它更轻量、更符合 Go 的设计哲学。

用 `interface` 定义被代理行为

代理模式的前提是存在一个清晰的行为契约。在 Go 中，这必须是一个 interface。比如一个文件读取服务：

type FileReader interface {
	Read(filename string) ([]byte, error)
}

注意：不要定义成具体结构体方法集，否则无法被不同实现（真实对象 / 代理）统一接受。

所有代理和真实对象都必须实现这个 FileReader
接口越小越好，避免把日志、缓存、鉴权等非核心职责塞进来
如果已有旧代码用结构体指针做参数，需先抽离为接口，否则无法注入
代理

实现真实对象与代理对象并组合

真实对象专注业务逻辑；代理对象持有真实对象，并在其方法前后插入横切逻辑：

type RealFileReader struct{}

func (r *RealFileReader) Read(filename string) ([]byte, error) {
	return os.ReadFile(filename)
}

type LoggingFileReader struct {
	reader FileReader // 组合，不是继承
}

func (l *LoggingFileReader) Read(filename string) ([]byte, error) {
	fmt.Printf("Reading file: %s\n", filename)
	data, err := l.reader.Read(filename)
	if err != nil {
		fmt.Printf("Read failed: %v\n", err)
	}
	return data, err
}

关键点：

LoggingFileReader 不嵌入 FileReader，而是显式声明字段 + 显式调用 l.reader.Read()
代理对象可嵌套：比如 LoggingFileReader{reader: &CachingFileReader{reader: &RealFileReader{}}}
避免循环依赖：代理和真实对象不能互相 import；通常把 interface 放在独立包（如 contract 或 port）

代理常用于控制访问或增强能力

Go 中典型的代理用途不是为了“替类挡访问”，而是为了无侵入地叠加能力：

缓存代理：检查 map[string][]byte 是否命中，未命中再调 reader.Read() 并写入缓存
限流代理：用 golang.org/x/time/rate.Limiter 在 Read() 前 limiter.Wait()
鉴权代理：检查 filename 是否在白名单中，否则返回 os.ErrPermission
重试代理：对临时错误（如网络 IO timeout）自动重试 2–3 次

这些都不需要修改 RealFileReader，只需新写一个结构体 + 实现同一接口 + 组合原对象。

小心隐式接口满足带来的误代理

Go 的接口是隐式实现的，容易“不小心”满足了某个接口而被当成代理目标：

比如你定义了 type Closer interface{ Close() error }，而 *os.File 恰好有 Close() 方法 —— 它就自动实现了 Closer
若你写了 type TracingCloser struct{ io.Closer }，它会直接嵌入并转发 Close()，但没加 trace 日志，等于白写
务必确认代理对象是否真的做了增强逻辑，而不是仅靠匿名字段“自动代理”

真正可控的代理，永远始于显式字段 + 显式方法实现，而不是匿名嵌入。