GORM 默认按结构体名复数形式推导表名，若 PostgreSQL 中表名与约定不符（如 test_table），需通过 TableName() 方法显式指定，避免因表名不匹配导致“relation does not exist”错误。
gorm 默认按结构体名复数形式推导表名，若 postgresql 中表名与约定不符（如 `test_table`），需通过 `tablename()` 方法显式指定，避免因表名不匹配导致“relation does not exist”错误。
在使用 GORM 查询已有数据库表（例如由 Yii2 迁移创建的 test_table）时，常见错误 (pq: relation "table_gos" does not exist) 实际源于 GORM 自动将结构体名 TableGo 转换为复数小写形式 table_gos 作为默认表名，而实际表名为 test_table，导致 SQL 查询失败。
解决方法是显式声明表名映射，无需调用 db.AutoMigrate()（该操作会尝试建表，可能破坏现有结构）。只需在 Go 结构体中实现 TableName() 方法：
type TableGo struct {
Id int `gorm:"primaryKey"`
Data string `gorm:"type:jsonb"`
}
// TableName 指定对应数据库表名，覆盖 GORM 默认命名规则
func (TableGo) TableName() string {
return "test_table"
}
⚠️ 注意事项：
- TableName() 是指针接收器或值接收器均可，但推荐使用值接收器（如上），避免意外修改结构体；
- 字段标签需准确匹配数据库列：Id 对应 id（GORM 默认忽略大小写，但建议保持一致），gorm:"primaryKey" 显式声明主键更安全；
- jsonb 类型字段建议使用 string 接收（如需结构化解析，可用 map[string]interface{} 或自定义类型 + sql.Scanner/driver.Valuer）；
- 查询时仍使用标准链式语法，无需额外配置：
var record TableGo
result := db.Where("id = ?", 75).First(&record)
if result.Error != nil {
log.Fatal("查询失败:", result.Error)
}
fmt.Println(record.Data) // 正确输出 JSONB 内容
总结：GORM 与遗留表集成的关键在于解耦模型定义与表管理——通过 TableName() 精确绑定，配合恰当的字段标签和类型映射，即可安全、高效地复用现有数据库结构，完全规避 AutoMigrate 带来的风险。
