本文介绍如何通过结构体嵌入和接口抽象避免重复定义结构体与手动字段复制，实现公共视图与管理视图的解耦，兼顾 dry 原则与安全性。
本文介绍如何通过结构体嵌入和接口抽象避免重复定义结构体与手动字段复制，实现公共视图与管理视图的解耦，兼顾 dry 原则与安全性。
在 Go 开发中，为同一数据模型提供不同访问级别的序列化视图（如 public/admin）时，直接维护多个结构体并手动同步字段极易违反 DRY 原则，且易引入遗漏或不一致 bug。最符合 Go 习惯的解决方案是结合结构体嵌入（embedding）与接口封装，而非依赖运行时 tag 覆盖或反射拷贝。
✅ 推荐方案：嵌入 + 接口抽象
首先，将公共字段提取为独立结构体 FooPublic，再让完整实体 Foo 嵌入它：
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"`
}
type Foo struct {
FooPublic // 嵌入 —— 自动继承字段与 JSON/BSON tag
AdminOnly string `json:"admin_only" bson:"admin_only"`
}
// 公共视图方法：零拷贝，直接返回嵌入字段
func (f *Foo) Public() FooPublic {
return f.FooPublic // 编译期安全，无字段遗漏风险
}
✅ 优势显著：
- 新增公共字段只需在 FooPublic 中定义一次，Foo 自动继承；
- Public() 方法无需维护字段赋值逻辑，消除手动同步错误；
- JSON/BSON 序列化行为由嵌入结构体的 tag 决定，清晰可控。
⚠️ 关键提醒：暴露结构体 ≠ 安全控制
仅靠 Public() 方法无法真正隐藏敏感字段——若调用方已持有 *Foo 实例，仍可直接访问 f.AdminOnly（因其为导出字段）。因此，真正的安全边界应设在接口层：
// 定义只读公共接口
type FooViewer interface {
GetID() bson.ObjectId
GetDateAdded() time.Time
GetBar() string
// AdminOnly 不在此接口中暴露
}
// 实现接口（内部结构体可保持私有）
type fooImpl struct {
id bson.ObjectId
dateAdded time.Time
bar string
adminOnly string
}
func (f *fooImpl) GetID() bson.ObjectId { return f.id }
func (f *fooImpl) GetDateAdded() time.Time { return f.dateAdded }
func (f *fooImpl) GetBar() string { return f.bar }
// 构造函数仅返回接口，隐藏具体结构
func NewFoo(id bson.ObjectId, date time.Time, bar, adminOnly string) FooViewer {
return &fooImpl{ id: id, dateAdded: date, bar: bar, adminOnly: adminOnly }
}
这样，外部代码只能通过 FooViewer 接口访问公共字段，AdminOnly 从编译期即不可见，彻底规避越权访问风险。
? 总结
- 优先使用嵌入：解决结构体复用与字段同步问题，简洁、高效、类型安全；
- 用接口代替结构体暴露：实现真正的访问控制，而非依赖“约定不访问”；
- 避免反射或 tag 动态覆盖：Go 不支持运行时修改 struct tags，此类方案复杂且不可靠；
- 警惕“伪安全”：Public() 方法仅是便利工具，不能替代权限隔离设计。
遵循此模式，既能保持代码简洁可维护，又能构建健壮的安全边界。
