Go+GORM插入数据失败：表与列名被加双引号致SQL无效

成因分析 #

GORM默认会给SQL语句中的表名、列名等标识符添加双引号，而PostgreSQL对标识符大小写的处理规则是：

• 未加双引号的标识符会被自动转换为小写
• 加了双引号的标识符会严格区分大小写

如果你的数据库表/列是小写且创建时未加双引号，GORM生成的带双引号的SQL会因为大小写不匹配找不到对应的表/列，最终导致插入操作失败。

解决方案 #

1. 禁用GORM的标识符引号功能

在初始化GORM数据库连接时，通过配置NamingStrategy.IdentifierQuote为空字符串，彻底关闭自动加引号的行为：

import (
  "gorm.io/driver/postgres"
  "gorm.io/gorm"
  "gorm.io/gorm/schema"
)

// 初始化PostgreSQL连接
func initPostgresDB() *gorm.DB {
  dsn := "host=xxx user=xxx password=xxx dbname=xxx port=5432 sslmode=disable"
  db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{
    NamingStrategy: schema.NamingStrategy{
      IdentifierQuote: "", // 关键：禁用双引号包裹标识符
      SingularTable: true, // 可选：设置为true让表名使用单数（比如record而不是records）
    },
  })
  if err != nil {
    panic("连接数据库失败: " + err.Error())
  }
  return db
}

2. 确保模型与数据库表/列名严格匹配

如果不想禁用引号，需要保证：

• 数据库表/列创建时使用双引号指定大小写（不推荐，会增加维护成本）
• 结构体标签中的column值和数据库列名完全一致（包括大小写），同时给结构体指定表名：

type Record struct {
  Company  string `json:"-" gorm:"column:company"`
  Category string `json:"-" gorm:"column:category"`
}

// 明确指定表名，和数据库中的表名完全一致
func (Record) TableName() string {
  return "records"
}

3. 补全事务逻辑代码

你提供的事务代码片段不完整，需要确保事务逻辑正确返回错误以触发回滚，示例如下：

err := dm.postgresDB.Transaction(func(tx *gorm.DB) error {
  if err := tx.Create(&rd).Error; err != nil {
    return err // 返回错误触发事务回滚
  }
  return nil // 返回nil提交事务
})
if err != nil {
  // 处理事务失败逻辑
}

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