如何正确将logger注入数据库层及model绑定方法并实现资源隔离？

Go语言中可以通过接口隔离+分层设计的方式完美解决这个需求，既可以把logger、db连接等内部资源注入到业务方法中，也不会把内部资源暴露给controller层，以下是两种最常用的落地方式：

方案一：Repository层抽离+窄接口暴露（最推荐） #

这是Go生态中最通用的实践，把业务逻辑从纯数据模型中剥离到独立的Repository层，对外仅暴露包含必要方法的接口，完全隐藏内部实现细节：

1. 首先定义纯数据Model，仅保留数据字段，不绑定业务方法：

type User struct {
    ID   string `json:"id" bson:"id"`
    Name string `json:"name" bson:"name"`
}

2. 定义面向controller的窄接口，仅声明controller需要调用的方法：

// UserRepository 对外暴露的用户数据操作接口，controller只能调用这里声明的方法
type UserRepository interface {
    Save(user *User) error
    // 其他需要对外暴露的方法按需添加，比如 GetByID、Delete 等
}

3. 定义内部实现struct，封装所有内部资源，实现上面的接口：

// userRepository 内部实现类，所有成员都是私有，外部不可访问
type userRepository struct {
    logger *zap.Logger // 你的日志实例
    dbConn *mongo.Client // 你的数据库连接实例
}

// Save 实现UserRepository接口的Save方法，内部可以自由使用封装的资源
func (repo *userRepository) Save(user *User) error {
    repo.logger.Info("开始保存用户", zap.String("user_id", user.ID))
    _, err := repo.dbConn.Database("your_db").Collection("user").InsertOne(context.TODO(), user)
    if err != nil {
        repo.logger.Error("保存用户失败", zap.Error(err), zap.String("user_id", user.ID))
        return err
    }
    return nil
}

4. 提供构造函数，仅返回接口类型，隐藏内部实现：

func NewUserRepository(logger *zap.Logger, dbConn *mongo.Client) UserRepository {
    return &userRepository{
        logger: logger,
        dbConn: dbConn,
    }
}

你只需要把UserRepository接口类型注入到controller即可，controller完全无法访问到内部的logger、db连接等资源，只会看到你暴露的业务方法。

方案二：方法参数注入依赖接口 #

如果你确实希望把业务方法绑定在User模型上，可以通过方法参数注入窄接口的方式实现隔离，不需要额外抽分层：

1. 定义业务方法需要的依赖接口，仅声明需要用到的能力：

// UserSaveDeps 仅暴露Save方法需要的能力，不需要完整暴露logger、db实例
type UserSaveDeps interface {
    Info(msg string, keysAndValues ...interface{})
    InsertUser(user *User) error
}

2. 给User模型绑定Save方法，接收上面的依赖接口作为参数：

func (user *User) Save(deps UserSaveDeps) error {
    deps.Info("开始保存用户", "user_id", user.ID)
    return deps.InsertUser(user)
}

3. 你的资源struct实现UserSaveDeps接口即可，controller调用Save时仅需传入接口，无法访问多余内部资源。

注意：该方案适合调用次数少的场景，缺点是每次调用Save都需要传递依赖参数，不如方案一方便维护。

不建议把业务逻辑直接绑定在纯数据Model上，分层设计不仅能解决依赖隔离的问题，还更方便做单元测试：你可以很轻松的MockUserRepository接口来测试controller逻辑，也可以传入Mock的logger、db实例来测试Repository层的逻辑。

内容的提问来源于stack exchange，提问作者Tauseef Ahmad