在 GORM 中，AutoMigrate 不会修改已存在列的约束（如 NOT NULL），需手动执行 ALTER TABLE 迁移并合理处理历史数据，默认值是安全添加非空约束的前提。
在 gorm 中，`automigrate` 不会修改已存在列的约束（如 `not null`），需手动执行 `alter table` 迁移并合理处理历史数据，默认值是安全添加非空约束的前提。
GORM 的 AutoMigrate 是一个便捷但保守的迁移机制——它仅创建缺失的表/字段、添加缺失的索引，绝不会删除字段、修改类型或变更约束（包括 NOT NULL、UNIQUE、默认值等）。因此，当你将模型从：
type User struct {
gorm.Model
Name string // 无约束
}
升级为：
type User struct {
gorm.Model
Name string `gorm:"not null"`
}
直接调用 db.AutoMigrate(&User{}) 不会生效，也不会报错，Name 列仍将保持可为空（NULL）。
✅ 正确做法是：使用原生 SQL 或 GORM 的 Exec 手动执行 ALTER TABLE，并严格遵循数据库约束变更的安全原则：
1. 必须先为现有空值提供默认值
PostgreSQL / MySQL / SQLite 均要求：向已有数据的列添加 NOT NULL 约束前，该列所有行必须有非空值。因此，迁移需分两步：
// Step 1: 为现有 NULL 值填充默认内容（以 PostgreSQL 为例）
if err := db.Exec("UPDATE users SET name = 'unknown' WHERE name IS NULL").Error; err != nil {
log.Fatal("failed to fill NULL names:", err)
}
// Step 2: 添加 NOT NULL 约束
if err := db.Exec("ALTER TABLE users ALTER COLUMN name SET NOT NULL").Error; err != nil {
log.Fatal("failed to add NOT NULL constraint:", err)
}
? 提示：若你希望后续新记录也强制非空且避免依赖数据库默认值，可在模型中同时声明
default（仅影响AutoMigrate新建表时）：Name string `gorm:"not null;default:'unknown'"`但注意：此
default不会自动回填历史 NULL 数据，仅对INSERT无显式值时生效。
2. 推荐封装为可复用的迁移函数
为保障可维护性与幂等性，建议将迁移逻辑封装为带版本检查的函数（例如配合 gorm.io/gorm/migrator 或自定义迁移管理器）：
func AddNotNullConstraintToUsersName(db *gorm.DB) error {
var count int64
db.Raw("SELECT COUNT(*) FROM users WHERE name IS NULL").Scan(&count)
if count > 0 {
if err := db.Exec("UPDATE users SET name = 'unnamed' WHERE name IS NULL").Error; err != nil {
return fmt.Errorf("failed to backfill NULL names: %w", err)
}
}
// 使用方言适配（此处以通用 SQL 为例；生产环境建议按数据库类型区分）
if err := db.Exec("ALTER TABLE users ALTER COLUMN name SET NOT NULL").Error; err != nil {
// MySQL 写法：ALTER TABLE users MODIFY COLUMN name VARCHAR(255) NOT NULL;
// SQLite 写法：需重建表（不支持直接 ALTER COLUMN），建议用 gormigrate 或 sqlc 辅助
return fmt.Errorf("failed to alter column: %w", err)
}
return nil
}
⚠️ 注意事项
-
数据库差异大：MySQL 使用
MODIFY COLUMN/CHANGE COLUMN，PostgreSQL 用ALTER COLUMN ... SET NOT NULL，SQLite 则几乎不支持直接约束变更，需手动导出-重建表。 -
事务安全：关键迁移建议包裹在事务中（
db.Transaction(...)），失败则回滚。 -
避免线上直接操作：大表迁移前务必在测试库验证，并评估
UPDATE和ALTER的锁表现（尤其 MySQL 的ALGORITHM=INPLACE支持情况）。 -
后续模型同步：约束添加成功后，应同步更新 GORM 模型标签（如
gorm:"not null"），确保AutoMigrate对未来新建环境生效，且代码语义清晰。
总之，GORM 不替代数据库迁移工具，而是与之协同：AutoMigrate 负责初始结构，复杂变更（含约束升级）须由开发者主导、精准控制。
