必须用类型别名（如UserDB、LogDB）区分不同*gorm.DB实例，否则Wire无法识别依赖差异，导致连接复用冲突、事务失效、主从分离失败；需配合wire.Bind、驱动导入、完整DSN及仓库精准接收别名类型。
直接用 wire.Build() 注入 *gorm.DB 是可行的，但必须显式区分实例、绑定类型别名、且驱动和 DSN 严格匹配——否则运行时查不到表、事务不生效、甚至连接卡死，错误提示还极其模糊。
为什么不能直接 wire.Build(NewDB, NewUserRepo, ...)
因为 NewDB() 返回的是裸指针 *gorm.DB，而多个仓库（比如 UserRepository 和 LogRepository）如果都依赖这个类型，Wire 会把它们当成同一个实例注入。实际中你很可能需要两个独立连接池（如主从分离、多租户、读写分离），这时所有 repo 全部共享一个 *gorm.DB 就会出问题。
- Wire 容器按类型识别依赖，
*gorm.DB是通用类型，无法区分“用户库”和“日志库” - 若没做类型别名，
userRepo和logRepo可能拿到同一个*gorm.DB实例，导致连接复用冲突或事务隔离失效 - 初始化失败时（如 DSN 错误），
NewDB()若不返回error，wire 生成的代码会 panic，且堆栈不指向具体配置位置
必须用类型别名区分不同数据库实例
给每个数据库连接定义唯一类型，让 Wire 能区分依赖。不是加注释，是真·新类型：
type UserDB *gorm.DB type LogDB *gorm.DB
对应初始化函数也要返回明确类型：
func NewUserDB() (UserDB, error) {
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{...})
return UserDB(db), err
}
func NewLogDB() (LogDB, error) {
db, err := gorm.Open(postgres.Open(logDSN), &gorm.Config{...})
return LogDB(db), err
}
- 别漏掉驱动导入：
import _ "gorm.io/driver/mysql"和import _ "gorm.io/driver/postgres"，下划线不能少 - DSN 中关键参数必须带全：MySQL 要
?charset=utf8mb4&parseTime=True&loc=Local，PostgreSQL 要?sslmode=disable - 用户名/密码含
@或/时，先用url.QueryEscape()编码，否则解析失败报"pq: password authentication failed"
仓库构造函数必须接收对应类型，而非 *gorm.DB
Repository 不该接受泛型 *gorm.DB，而应接收你定义的别名类型，这样 Wire 才能精准绑定：
type UserRepository struct {
db UserDB
}
func NewUserRepository(db UserDB) *UserRepository {
return &UserRepository{db: db}
}
- 如果写成
func NewUserRepository(db *gorm.DB)，Wire 会把UserDB和LogDB都转成*gorm.DB后注入，失去区分意义 - 事务只对调用它的那个实例生效：
userDB.Transaction()内调logDB.Create()完全游离在事务外——这不是 bug，是 GORM 明确设计 - 别在
func init()里开 DB：失败无法返回 error，日志无上下文，Wire 生成的初始化链会中断在不可知位置
wire.go 中 ProviderSet 要显式声明类型转换
Wire 不会自动把 UserDB 当作 *gorm.DB 使用，你需要用 wire.Bind 告诉它“这个别名可被当作 gorm.DB 用”（仅当 repo 内部确实只调
db.<code> 方法时才需）：</p>
<pre class='brush:php;toolbar:false;'>var ProviderSet = wire.NewSet(
NewUserDB,
NewLogDB,
NewUserRepository,
NewLogRepository,
wire.Bind(new(*gorm.DB), new(UserDB)),
wire.Bind(new(*gorm.DB), new(LogDB)),
)
- 上面两行
wire.Bind 表示：当某个函数参数是 <code>*gorm.DB类型时，可用UserDB或LogDB实例满足 - 但更推荐仓库直接依赖
UserDB/LogDB，避免隐式转换——类型越精确，越早暴露误用 - 运行
wire命令后检查生成的wire_gen.go，确认NewUserRepository确实接收的是UserDB，而不是*gorm.DB
最易忽略的一点：GORM 的 Transaction()、Session()、Scopes() 全部绑定到具体 *gorm.DB 实例，跨别名调用等于跨连接池操作——看起来代码能跑，但数据一致性、超时、锁行为全不可控。
