gorm建表失败常见于结构体字段未导出（首字母小写），导致生成空表语句如 create table user()，触发mysql 1064语法错误；正确做法是将字段首字母大写使其可导出，并规范错误处理逻辑。
gorm建表失败常见于结构体字段未导出（首字母小写），导致生成空表语句如 create table user()，触发mysql 1064语法错误；正确做法是将字段首字母大写使其可导出，并规范错误处理逻辑。
在使用 GORM 进行数据库建表时，一个看似简单却极易踩坑的问题是：调用 db.CreateTable(&User{}) 后报错 Error 1064: You have an error in your SQL syntax... near ') ENGINE=InnoDB'。该错误并非数据库连接问题（日志中显示连接成功），而是 GORM 生成了非法 SQL —— 一张不含任何列定义的空表语句，例如：
CREATE TABLE `users` () ENGINE=InnoDB;
这在 MySQL 中完全非法，直接被服务端拒绝执行。
? 根本原因：Go 结构体字段未导出（Unexported Fields）
GORM 依赖 Go 的反射（reflect）机制扫描结构体字段，以生成对应的数据表结构。而根据 Go 语言规范，只有首字母大写的字段才是“导出的”（exported），才能被外部包（如 GORM）访问。若字段定义为小写（如 id int），GORM 无法读取该字段，进而认为该结构体“无有效字段”，最终生成空括号表定义。
你原始代码中的关键问题就在这里：
type User struct {
id int // ❌ 小写 id → 非导出字段 → GORM 忽略！
}
✅ 正确写法应为：
type User struct {
ID uint `gorm:"primaryKey"` // ✅ 导出字段 + 显式主键声明（推荐）
// 或更完整的标准模型：
// gorm.Model // 内置 ID, CreatedAt, UpdatedAt, DeletedAt
}
? 提示：GORM v2（gorm.io/gorm）已弃用 CreateTable，推荐统一使用 AutoMigrate —— 它不仅创建表，还智能处理字段变更、索引、约束等，且强制要求字段可导出。
✅ 完整修复示例（GORM v2 + MySQL）
package main
import (
"log"
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
type User struct {
ID uint `gorm:"primaryKey"`
Name string `gorm:"size:100;not null"`
}
func main() {
dsn := "root:vertrigo@tcp(127.0.0.1:3306)/shop?charset=utf8mb4&parseTime=True&loc=Local"
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
log.Fatal("failed to connect database:", err)
}
// ✅ 推荐方式：自动迁移（含建表+字段同步）
err = db.AutoMigrate(&User{})
if err != nil {
log.Fatal("failed to migrate schema:", err)
}
log.Println("✅ Table 'users' created successfully!")
}
⚠️ 其他关键注意事项
- 字符集与排序规则：若插入中文时报错 Error 1366: Incorrect string value，说明表字符集不支持 UTF-8 多字节（如 utf8mb4）。应在 DSN 中指定 charset=utf8mb4，并确保 MySQL 服务端配置支持（collation-server = utf8mb4_unicode_ci）。
- 时间字段缺失：若模型嵌入 gorm.Model 却未执行 AutoMigrate，插入时可能报 Unknown column 'created_at'。务必通过 AutoMigrate 同步内置字段。
-
错误处理规范：切勿仅 fmt.Println(err)。GORM v2 的错误统一通过返回值暴露，应显式判断：
result := db.Create(&user) if result.Error != nil { log.Printf("create failed: %v", result.Error) return } log.Printf("affected rows: %d", result.RowsAffected) - 避免 CreateTable（已废弃）：CreateTable 不处理字段变更、索引、外键等，且不兼容 GORM v2 的钩子与插件体系，生产环境务必使用 AutoMigrate。
? 总结
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| Error 1064: ... near ')' | 结构体字段未导出（小写首字母）→ GORM 生成空表 | 字段名首字母大写（如 ID, Name） |
| Error 1054: Unknown column 'created_at' | 模型含 gorm.Model 但未迁移建表 | 使用 db.AutoMigrate(&Model{}) |
| Error 1366: Incorrect string value | 表/列字符集非 utf8mb4 | DSN 加 charset=utf8mb4，建表时指定 COLLATE utf8mb4_unicode_ci |
遵循“导出字段 + AutoMigrate + 显式错误检查”三原则，即可规避 90% 的 GORM 建表与插入异常。
