GORM 配置项#

基础配置#

1
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
2
  SkipDefaultTransaction: true,
3
  PrepareStmt:             true,
4
  NamingStrategy: schema.NamingStrategy{
5
    TablePrefix:   "t_",
6
    SingularTable: true,
7
    NameReplacer:  strings.NewReplacer("CID", "Cid"),
8
  },
9
  Logger: logger.Default.LogMode(logger.Warn),
10
})

常用 `gorm.Config`#

配置	作用	使用建议
`SkipDefaultTransaction`	写操作不自动包裹默认事务	只有确认业务不依赖默认事务且完成压测后再开启
`PrepareStmt`	缓存 prepared statement	适合重复 SQL；注意 statement 和连接资源开销
`NamingStrategy`	表名、列名和关系名命名策略	项目启动时统一设置，避免中途改变
`Logger`	SQL、耗时和错误日志	开发用 Info，生产通常 Warn/Error
`NowFunc`	自定义时间来源	测试固定时间或统一时区时使用
`DryRun`	只生成 SQL，不真正执行	调试和测试 SQL 形状
`TranslateError`	尝试把驱动错误转换为 GORM 通用错误	仍需保留原始错误用于排查
`DisableForeignKeyConstraintWhenMigrating`	AutoMigrate 时不创建外键约束	只有有明确迁移策略时使用
`CreateBatchSize`	设置批量创建默认批次	大批量导入时结合数据库限制调节
`DisableNestedTransaction`	禁用嵌套事务的保存点行为	需要理解事务边界后再改

命名策略#

1
NamingStrategy: schema.NamingStrategy{
2
  TablePrefix:         "t_",  // users -> t_users
3
  SingularTable:       true,  // User -> user
4
  NoLowerCase:         false,
5
  IdentifierMaxLength: 64,
6
}

命名策略属于全局约定。项目已经上线后不要随意修改，否则同一模型可能映射到另一张表。

单个模型需要覆盖表名时：

1
func (Order) TableName() string {
2
  return "orders_archive"
3
}

日志配置#

1
newLogger := logger.New(
2
  log.New(os.Stdout, "\r\n", log.LstdFlags),
3
  logger.Config{
4
    SlowThreshold:             200 * time.Millisecond,
5
    LogLevel:                  logger.Warn,
6
    IgnoreRecordNotFoundError: true,
7
    ParameterizedQueries:      true,
8
    Colorful:                  false,
9
  },
10
)

ParameterizedQueries: true 可以避免日志打印完整参数，降低敏感数据泄露风险；需要排查具体参数时，应在受控环境短暂调整日志，而不是长期打开。

Session 级配置#

不是所有配置都应该放到初始化阶段。一次操作需要特殊行为时，使用 Session：

1
// 只允许这个操作无条件更新，慎用
2
err := db.Session(&gorm.Session{
3
  AllowGlobalUpdate: true,
4
}).Model(&User{}).Update("status", "inactive").Error
5

6
// 只对这次会话启用 Debug
7
db.Session(&gorm.Session{Logger: logger.Default.LogMode(logger.Info)}).
8
  Where("id = ?", id).
9
  First(&user)

避免把 AllowGlobalUpdate 设置到全局配置；无条件更新和删除应默认被拦截。

`Debug`、`DryRun` 和 `ToSQL`#

1
// 临时打印本次操作的 SQL
2
db.Debug().Where("email = ?", email).First(&user)
3

4
// 只构建 SQL，不发送到数据库
5
stmt := db.Session(&gorm.Session{DryRun: true}).
6
  Where("age > ?", 18).
7
  Find(&users).Statement
8
fmt.Println(stmt.SQL.String(), stmt.Vars)

DryRun 适合检查 SQL 结构，但不能证明数据库实际执行计划、索引选择或权限都正确。

配置分层建议#

应用启动配置：数据库驱动、gorm.Config、日志、命名策略。
环境配置：DSN、连接池、日志级别、慢 SQL 阈值。
请求级配置：WithContext、Debug、超时和事务。
测试配置：SQLite/临时数据库、DryRun、固定 NowFunc。

HikariTish

GORM 配置项#

基础配置#

常用 `gorm.Config`#

命名策略#

日志配置#

Session 级配置#

`Debug`、`DryRun` 和 `ToSQL`#

配置分层建议#

官方资料#

继续阅读

换条路线

HikariTish

GORM 配置项#

基础配置#

常用 gorm.Config#

命名策略#

日志配置#

Session 级配置#

Debug、DryRun 和 ToSQL#

配置分层建议#

官方资料#

分享文章

沿着主题读

换条路线

常用 `gorm.Config`#

`Debug`、`DryRun` 和 `ToSQL`#