Wire是否支持注入命名依赖？多*sql.DB依赖场景需求

核心结论 #

命名依赖是这类场景下的推荐方案，且Wire完全支持该特性。

为什么推荐命名依赖？ #

当业务服务需要依赖多个同类型但不同数据源的实例（比如指向不同MySQL后端的*sql.DB），仅靠类型注入会产生歧义——框架无法区分哪个实例对应哪个业务用途（主库、从库、业务库、日志库等）。命名依赖通过给每个实例赋予唯一标识，能明确绑定依赖关系，提升代码可读性与可维护性，彻底避免注入错误。

Wire实现命名依赖的方式 #

Wire通过wire.Named()函数标记命名提供者，结合结构体标签或显式绑定完成注入，以下是具体示例：

1. 定义带命名的提供者 #

首先实现不同数据源的初始化函数，在Wire集合中用wire.Named()为实例标记名称：

import (
    "database/sql"
    "github.com/google/wire"
)

// 初始化主库DB
func NewMainDB() (*sql.DB, error) {
    // 主库连接逻辑
}

// 初始化从库DB
func NewReplicaDB() (*sql.DB, error) {
    // 从库连接逻辑
}

// 定义DB集合，为实例添加命名标识
var DBSet = wire.NewSet(
    NewMainDB, wire.Named("mainDB"),
    NewReplicaDB, wire.Named("replicaDB"),
)

2. 在业务结构体中指定命名依赖 #

通过结构体标签wire:"名称"明确每个字段对应的依赖实例：

type OrderService struct {
    MainDB     *sql.DB `wire:"mainDB"`   // 绑定主库实例
    ReplicaDB  *sql.DB `wire:"replicaDB"` // 绑定从库实例
}

// 服务构造函数
func NewOrderService(mainDB *sql.DB, replicaDB *sql.DB) *OrderService {
    return &OrderService{
        MainDB: mainDB,
        ReplicaDB: replicaDB,
    }
}

3. 组合Wire集合完成注入 #

将DB集合与服务构造函数组合，Wire会自动根据命名匹配依赖：

var ServiceSet = wire.NewSet(
    DBSet,
    NewOrderService,
)

注意事项 #

• 命名需贴合业务场景（如userDB、orderDB），避免使用db1、db2这类无意义标识。
• 不要滥用命名依赖：仅当同类型实例存在明确业务区分时使用，常规场景下保持类型注入的简洁性。

内容的提问来源于stack exchange，提问作者Jason Xu