本文介绍如何在 go 中避免重复定义结构体和手动复制字段，通过结构体嵌入和接口抽象实现公共/管理员视图的 dry 安全设计。
本文介绍如何在 go 中避免重复定义结构体和手动复制字段，通过结构体嵌入和接口抽象实现公共/管理员视图的 dry 安全设计。
在构建 API 或服务层时，常见需求是为同一数据实体提供不同粒度的序列化视图：例如，公开接口仅返回基础字段（id, date_added, bar），而管理后台可访问敏感字段（如 admin_only）。若采用为每种视图单独定义结构体 + 手动字段赋值的方式（如 FooPublic + Public() 方法），不仅违反 DRY 原则，还会因新增字段需同步修改三处（主结构体、视图结构体、复制逻辑）而显著增加维护成本和出错风险。
推荐方案：结构体嵌入 + 接口封装
最符合 Go 习惯的解法是利用结构体嵌入（embedding） 提升复用性，并结合接口抽象隐藏底层实现细节，从根本上规避未授权访问风险：
// 公共视图结构体 —— 定义所有对外暴露的字段及其序列化标签
type FooPublic struct {
Id bson.ObjectId `json:"id" bson:"_id"`
DateAdded time.Time `json:"date_added" bson:"date_added"`
Bar string `json:"bar" bson:"bar"`
}
// 主实体结构体 —— 嵌入 FooPublic，自然继承其字段与 JSON/BSON 标签
type Foo struct {
FooPublic // 匿名字段，支持直接访问 Id/DateAdded/Bar
AdminOnly string `json:"admin_only,omitempty" bson:"admin_only"`
}
// Public 方法只需直接返回嵌入字段，零复制、零维护成本
func (f *Foo) Public() FooPublic {
return f.FooPublic
}✅ 优势说明：
- 新增公共字段时，仅需在 FooPublic 中声明一次，Foo 自动继承；
- Public() 方法无需更新，编译器保证类型安全；
- JSON 序列化行为由 FooPublic 的 tag 统一控制，无歧义。
⚠️ 关键提醒：嵌入 ≠ 安全隔离
单纯使用 Foo.Public() 并不能防止恶意访问——只要调用方持有 *Foo 实例，仍可直接读取 f.AdminOnly（因其为导出字段）。因此，真正的安全边界应落在接口层：
// 定义只读公共接口（不暴露 AdminOnly）
type FooViewer interface {
GetID() bson.ObjectId
GetDateAdded() time.Time
GetBar() string
// AdminOnly 不在此接口中声明 → 编译期强制不可见
}
// 实现接口（内部方法可安全访问 AdminOnly）
func (f *Foo) GetID() bson.ObjectId { return f.Id }
func (f *Foo) GetDateAdded() time.Time { return f.DateAdded }
func (f *Foo) GetBar() string { return f.Bar }
// 处理 HTTP 请求时，仅向 public handler 传递接口实例
func handlePublicFoo(w http.ResponseWriter, viewer FooViewer) {
json.NewEncoder(w).Encode(viewer) // 仅序列化接口定义的字段
}通过接口抽象，你将数据访问契约与具体实现分离：外部代码只能通过 FooViewer 调用受限方法，AdminOnly 字段在编译期即被屏蔽，彻底消除意外暴露风险。
总结
- ✅ 优先使用嵌入（FooPublic）减少结构体冗余与复制逻辑；
- ✅ 必须配合接口（FooViewer）实现运行时与编译期双重安全；
- ❌ 避免依赖“约定俗成”的 Public() 方法——它无法阻止反射或直接字段访问；
- ? 若需深度定制序列化（如动态 omit），可进一步结合 json.Marshaler 接口，但多数场景嵌入+接口已足够简洁健壮。
