
gorp 当前版本(v2.x)的 createtables() 方法不原生支持通过结构体标签声明数据库列的默认值,需借助 sql ddl 手动执行 alter table 或使用迁移工具实现。
gorp 是一个轻量级的 Go ORM 映射库,其 DbMap.CreateTables() 方法基于结构体反射自动生成基础建表语句(如 CREATE TABLE ...),但仅支持映射字段类型、主键、非空约束和索引等基本元信息,不解析或生成 DEFAULT 子句。这意味着即使你在结构体字段上添加类似 db:"name,default:'unknown'" 的标签,gorp 也不会将其转化为 SQL 中的 DEFAULT 'unknown' 定义。
例如,以下结构体:
type User struct {
Id int64 `db:"id,primarykey,autoincrement"`
Name string `db:"name"`
CreatedAt time.Time `db:"created_at"`
}调用 dbmap.CreateTables() 后,生成的 SQL 类似于:
CREATE TABLE user (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(255),
created_at DATETIME
);⚠️ 注意:created_at 字段不会自动添加 DEFAULT CURRENT_TIMESTAMP,即使你期望如此。
正确做法:分两步完成默认值设置
- 先调用 CreateTables() 建表(获取基础结构);
- 再执行手动 DDL 添加默认值(适配目标数据库语法):
// 步骤 1:创建基础表
err := dbmap.CreateTables()
if err != nil {
log.Fatal("Failed to create tables:", err)
}
// 步骤 2:为 created_at 添加默认值(MySQL 示例)
_, err = dbmap.Exec("ALTER TABLE user ALTER COLUMN created_at SET DEFAULT CURRENT_TIMESTAMP")
if err != nil {
log.Fatal("Failed to set default for created_at:", err)
}? 数据库兼容性提示: MySQL 使用 ALTER TABLE ... ALTER COLUMN ... SET DEFAULT ...(8.0+)或 MODIFY COLUMN ... DEFAULT ...; PostgreSQL 使用 ALTER TABLE ... ALTER COLUMN ... SET DEFAULT ...; SQLite 需在建表时定义(CREATE TABLE ... created_at DATETIME DEFAULT CURRENT_TIMESTAMP),因此建议对 SQLite 跳过 CreateTables(),改用 Exec() 直接执行完整建表语句。
替代方案:使用迁移工具(推荐生产环境)
对于需要长期维护默认值、约束、索引演进的项目,建议弃用 CreateTables() 的一次性建表逻辑,转而采用结构化迁移方案,例如:
- golang-migrate/migrate(支持多数据库、版本化 SQL 迁移)
- 自定义迁移脚本(按 V1__init.sql, V2__add_default_to_created_at.sql 组织)
这样既能精准控制 DEFAULT 行为,又能保障跨环境一致性与可回滚性。
✅ 总结:
- gorp.CreateTables() 是便捷的原型开发工具,但不具备默认值、检查约束、外键等高级 DDL 能力;
- 默认值必须通过后续 DDL 或迁移显式注入;
- 永远根据实际数据库方言编写对应 SQL,避免跨库假设;
- 关注 PR #209 —— 社区正在评审支持 default 标签的增强提案,未来版本可能原生支持(但尚未合并发布)。










