GO分层架构【4】Repository获取 *gorm.DB

Repository(或 Infra) 要如何获取 *gorm.DB 对象的?是通过全局变量,还是通过结构体注入?

在 Go 的 GORM 开发中,获取 *gorm.DB 对象主要有两种流派:"简单粗暴型"和"工程严谨型"。

作为一名 Go 开发者,理解这两者的区别对你调整架构至关重要:

1. 全局变量模式(简单粗暴型)

这是很多教程里的写法。在 infra 包里定义一个全局变量 DB。

  • 代码长这样:

    复制代码
    // internal/infra/db.go
    var DB *gorm.DB
    
    func InitDB() {
        db, _ := gorm.Open(...)
        DB = db
    }
  • 如何调用: 在任何地方(Handler/Logic/Repo)直接调用 infra.DB.Find(&user)。

  • 评价:

    • 优点:写起来极快,不用传参。
    • 缺点:极其难测。如果你想写单元测试,或者想连接两个不同的数据库,全局变量会让你痛不欲生。而且这种隐藏的依赖关系会导致代码越写越乱。

2. 结构体注入模式(工程严谨型 - 推荐)

这是主流微服务(如 go-zero, kratos)和互联网大厂的写法。

  • 代码逻辑:

    1. infra 负责生成 *gorm.DB 并返回。
    2. repository 定义一个结构体,把 *gorm.DB 存进去。
    3. logic 调用 repository 的实例。
  • 代码示例:

    复制代码
    // internal/repository/user_repo.go
    type UserRepo struct {
        db *gorm.DB // 私有变量,不暴露给外面
    }
    
    // 构造函数,创建 Repo 时必须传入 DB
    func NewUserRepo(db *gorm.DB) *UserRepo {
        return &UserRepo{db: db}
    }
    
    func (r *UserRepo) FindByID(id uint) (*model.User, error) {
        var user model.User
        err := r.db.First(&user, id).Error
        return &user, err
    }

3. 为什么推荐"结构体注入"?

  1. 链路清晰:你在 main.go 启动时就能一眼看出:DB 传给了 Repo,Repo 传给了 Logic。
  2. 方便做"假"测试(Mock):写单元测试时,你可以传一个模拟的 DB 进去,而不需要真的连数据库。
  3. 支持多库:如果你以后业务大了,读写分离或者有多个库,你只需要在初始化时传入不同的 DB 实例即可,逻辑层代码一行都不用改。

4. 结合你之前的架构:如何串联起来?

如果你打算采用推荐的写法,你的 main.go 启动流程大致如下:

  1. 加载配置:cfg := config.Load()
  2. 初始化基础设施:db := infra.NewDB(cfg) (返回 *gorm.DB)
  3. 创建 Repository:userRepo := repository.NewUserRepo(db)
  4. 创建 Logic:userLogic := logic.NewUserLogic(userRepo)
  5. 注册 Handler:r.POST("/user", handler.NewUserHandler(userLogic))

相关推荐
小杨互联网19 小时前
Go 现代 CLI 工具离线镜像合集
开发语言·后端·golang·开源·go·命令行
hourinX21 小时前
从直接填格子到筛选图案:头像生成这部分是怎样改过来的—— gdenticon 重构日志(三)
go
我不会起名字3221 天前
Redis 从 0 到 1(十三):分布式锁被误删、锁不住?Go 无 Lua 实现 3 级防御
redis·go·分布式锁·watch·setnx
hourinX2 天前
从 v1 到 v2,我重新拆了头像生成的整条链路—— gdenticon 重构日志(二)
go
FungLeo2 天前
成为全栈·Go 后端篇·分类树与标签关系:目录变更为何需要协调
golang·go·gorm·数据库事务·分类树·成为全栈
FungLeo2 天前
成为全栈·Go 后端篇·文章查询与展示投影:安全分页、排序和软删除
golang·go·gorm·分页查询·成为全栈·sql安全
KevinAshen673 天前
用 Go 修复旧下载工具:从接口 403 到凭证截断的完整复盘
go·github
FungLeo4 天前
成为全栈·Go 后端篇·跨语言认证兼容:Node 与 Go 如何互认 JWT 和密码
golang·go·jwt·身份认证·成为全栈·bcrypt
FungLeo4 天前
成为全栈·Go 后端篇·重写之前先锁基线:契约、Node 版本与行为清单
golang·node.js·go·openapi·契约测试·成为全栈
小满zs4 天前
Go语言第十七章(反射)
后端·go