在 clean architecture 的 go 实现中，领域层需与数据库无关地定义 id 类型，同时保持编译期类型安全；本文介绍一种基于接口抽象 + 外层具体实现的 idiomatic 方案，兼顾依赖倒置、类型安全与可扩展性。
在 clean architecture 的 go 实现中，领域层需与数据库无关地定义 id 类型，同时保持编译期类型安全；本文介绍一种基于接口抽象 + 外层具体实现的 idiomatic 方案，兼顾依赖倒置、类型安全与可扩展性。
在 Clean Architecture 的分层约束下（领域层最内、基础设施层最外），User 及其 ID 必须严格驻留在领域层，且不能导入任何外部依赖（如 mongo.ObjectId 或 sql.NullInt64）。但直接使用 interface{} 会丧失类型检查，而硬编码 string 或 int 又违背“ID 实现应由外层决定”的原则。理想的解法是：用最小契约接口抽象 ID 行为，将具体序列化逻辑下沉至基础设施层实现。
推荐采用以下领域层定义：
// domain/user.go —— 领域层（无外部导入）
type UserID interface {
// 唯一强制契约：可无损往返转换为字符串（用于日志、缓存键、API 序列化等通用场景）
String() string
// 支持从字符串解析（便于 HTTP 路由参数、JSON 解码等跨层传递）
Parse(string) error
}
type User struct {
ID UserID
Username string
// ... 其他纯业务字段
}
type UserRepository interface {
FindByID(id UserID) (*User, error)
Save(user *User) error
}
该接口仅约定 String() 和 Parse() 两个方法，不暴露底层类型（如 int/string/[12]byte），也不强制实现细节（如是否可变、是否线程安全），符合领域层“只关心业务语义”的定位。
在基础设施层（如 infrastructure/mongo/ 或 infrastructure/postgres/），按需实现具体 ID 类型：
// infrastructure/mongo/user_id.go
type MongoUserID struct {
oid primitive.ObjectID // 依赖 mongo-go-driver，仅此文件可见
}
func (id MongoUserID) String() string {
return id.oid.Hex()
}
func (id *MongoUserID) Parse(s string) error {
oid, err := primitive.ObjectIDFromHex(s)
if err != nil {
return fmt.Errorf("invalid MongoDB ObjectId: %w", err)
}
*id = MongoUserID{oid: oid}
return nil
}
// infrastructure/postgres/user_id.go
type PgUserID struct {
value int64
}
func (id PgUserID) String() string {
return strconv.FormatInt(id.value, 10)
}
func (id *PgUserID) Parse(s string) error {
v, err := strconv.ParseInt(s, 10, 64)
if err != nil {
return fmt.Errorf("invalid PostgreSQL user ID: %w", err)
}
*id = PgUserID{value: v}
return nil
}
关键优势：
- ✅ 完全遵守依赖规则：领域层 UserID 接口不引用任何基础设施类型，外层实现可自由替换；
- ✅ 编译期类型安全：FindByID(id UserID) 拒绝传入 int 或 string，强制使用合规实现；
- ✅ 统一序列化契约：所有 ID 在日志、HTTP、缓存等场景下行为一致（String() 作为标准化输出入口）；
- ✅ 错误处理显式化：Parse() 返回 error，避免静默失败（如无效 Hex 字符串）；
- ✅ 零运行时开销：接口仅含两个小方法，Go 编译器可高效内联。
⚠️ 注意事项：
- 避免在领域层为 UserID 添加业务方法（如 IsAdmin()），ID 是值对象，非实体；
- 若需 ID 比较相等性，应在接口中补充 Equal(other UserID) bool 方法，并在外层实现中基于底层值比较；
- 不要实现 fmt.Stringer 以外的格式化接口（如 json.Marshaler），序列化逻辑应交由专门的 DTO 或适配器处理；
- 所有 UserID 实现必须是不可变或值语义安全的——例如 MongoUserID 使用值接收器，PgUserID 的 Parse 方法修改指针接收器是合理例外。
总结：Clean Architecture 下的 ID 抽象，核心不是“隐藏类型”，而是“声明最小必要契约”。String() + Parse() 接口以极简设计平衡了类型安全、分层隔离与工程可维护性，是 Go 生态中契合架构原则的成熟实践。
