Go中代理必须手动实现接口全部方法，无法用reflect.Value.Call通用转发；延迟加载需用sync.Once并显式处理初始化失败状态。

Go 里没有语言级的 Proxy 类型，所谓“代理”，就是手动写一个结构体，实现和真实对象**完全一致的接口**，并在每个方法里显式调用真实对象——没捷径，也不能靠反射自动转发。

为什么不能用 reflect.Value.Call 做通用代理

常见错误是写个泛型 wrapper，试图用 reflect.Value.Call 把所有方法包一层。结果一运行就 panic：call of reflect.Value.Call on zero Value。

• reflect.Value 只能调用已导出方法，且接收者类型必须严格匹配（*T vs T）
• 接口方法签名稍有差异（比如参数名不同、error 返回位置不对），reflect 就无法绑定
• Go 的接口实现是编译期静态检查的，你无法在运行时“生成新类型”去满足某个接口

别绕弯子。要代理，就老老实实定义接口、写结构体、显式委托。

代理结构体必须显式实现全部接口方法

假设你有接口 DataService，含 Get、Save、Delete 三个方法。那你的 AuthProxy 就必须也写这三个方法，一个都不能少，签名一个都不能改。

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

立即学习“go语言免费学习笔记（深入）”；

• 漏写 Delete？传 AuthProxy{} 给期待 DataService 的函数，编译直接报错：missing method Delete
• 把 Get(id int) 写成 Get(ID int)？编译器照样报：method has different signature
• 别想用嵌入 DataService 字段来“自动透传”——嵌入只提供字段访问，不自动实现接口方法

正确做法：每个方法体内明确写 p.real.Get(id)，或加逻辑后决定是否调用。没捷径。

延迟加载必须用 sync.Once，且要处理初始化失败

延迟加载不是简单写个 if p.real == nil { p.real = newReal() } 就完事。并发下会重复初始化、资源泄漏，甚至 panic。

• 必须用 sync.Once 包裹初始化逻辑，例如 p.once.Do(p.initReal)
• initReal 方法里如果初始化失败（比如数据库连不上），得把错误存到字段（如 p.initErr），后续调用直接返回它，而不是重试
• 如果真实对象字段是 *RealService，所有方法开头都要加 if p.real == nil { return ..., p.initErr }，否则可能 panic

真正容易被忽略的是：初始化失败后的状态管理——它不是临时故障，而是代理进入“永久不可用”状态，这个语义必须由你显式表达，不能靠重试掩盖。