本文介绍通过结构体嵌入和接口抽象来避免重复定义公共/私有字段，解决 go 中结构体 json 标签按角色动态控制的问题，兼顾 dry 原则与安全性。
本文介绍通过结构体嵌入和接口抽象来避免重复定义公共/私有字段，解决 go 中结构体 json 标签按角色动态控制的问题，兼顾 dry 原则与安全性。
在 Go 开发中，常见需求是同一数据模型需面向不同角色（如普通用户与管理员）暴露不同字段。若采用为每种角色单独定义结构体（如 Foo 和 FooPublic）并手动复制字段，不仅违反 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"`
}
type Foo struct {
FooPublic // 嵌入公共字段（自动继承字段+方法）
AdminOnly string `json:"admin_only" bson:"admin_only"`
}
func (f *Foo) Public() FooPublic {
return f.FooPublic // 零拷贝返回嵌入字段，无需逐字段赋值
}
该设计显著提升可维护性：新增公共字段时，只需在 FooPublic 中声明一次，Foo 自动继承；Public() 方法也无需修改，天然保持同步。
⚠️ 但需注意关键安全前提：仅靠 Public() 方法无法真正隐藏敏感字段。一旦调用方持有 *Foo 实例，即可直接访问导出字段 AdminOnly（Go 中首字母大写即为导出字段）。因此，真正的权限隔离不应依赖“不调用某方法”，而应控制结构体的可见范围。
✅ 更健壮的做法：用接口抽象数据契约
将 Foo 的具体实现细节对外隐藏，仅暴露角色特定的只读接口：
// 定义公共视图契约
type FooViewer interface {
GetID() bson.ObjectId
GetDateAdded() time.Time
GetBar() string
}
// 定义管理员视图契约（可额外包含 AdminOnly）
type FooAdminViewer interface {
FooViewer
GetAdminOnly() string
}
// 具体实现（非导出，包内使用）
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 (f *fooImpl) GetAdminOnly() string { return f.adminOnly }
// 构造函数根据角色返回对应接口
func NewFooForPublic(id bson.ObjectId, date time.Time, bar string) FooViewer {
return &fooImpl{ id: id, dateAdded: date, bar: bar }
}
func NewFooForAdmin(id bson.ObjectId, date time.Time, bar, admin string) FooAdminViewer {
return &fooImpl{ id: id, dateAdded: date, bar: bar, adminOnly: admin }
}
此方式从根本上杜绝了越权访问：外部代码只能通过接口访问限定方法，AdminOnly 字段对公共接口完全不可见，且 fooImpl 类型本身不导出，无法被外部直接实例化或反射获取。
总结
- ✅ 优先使用嵌入简化字段复用，降低维护成本；
- ✅ 但务必配合接口抽象实现真正的访问控制，而非依赖“约定不访问”；
- ❌ 避免为每个角色重复定义结构体并手动映射——这是反模式；
- ? 敏感字段永远不应出现在公共结构体的字段列表中，即使 JSON tag 被忽略，内存/反射仍可能泄露。
通过组合嵌入与接口，你既能享受 Go 的简洁性，又能构建安全、可演进的领域模型。
