xorm和gorm连接mariadb时需显式配置parsetime=true和loc=local，xorm用xorm:"pk autoincr unsigned"映射int unsigned主键，gorm需手动指定字符集与引擎，二者批量插入和事务回滚机制亦不同。
xorm 和 gorm 是 Go 项目里连 MariaDB 最常用的两个 ORM 框架，但它们在初始化、字段映射、时间处理和错误反馈上差异明显。直接套用 MySQL 示例到 MariaDB 容易出错，尤其在字符集、时区、自动创建表等环节。
连接 MariaDB 时 DSN 必须显式指定 parseTime=true 和 loc=Local
MariaDB 默认返回的时间类型（如 TIMESTAMP）会被 Go 的 database/sql 驱动解析为字符串，导致 time.Time 字段解码失败或 panic。
-
parseTime=true启用驱动将时间字段转为time.Time类型 -
loc=Local避免因服务器时区与应用时区不一致导致时间偏移（MariaDB 常用system或Europe/Bucharest等非 UTC 时区） - DSN 示例：
"root:pass@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=true&loc=Local" - 漏掉
parseTime=true会导致xorm的created/updated标签失效，gorm的CreatedAt字段为空或零值
xorm 的结构体标签必须用 xorm:，且 autoincr 不兼容 MariaDB 的 INT UNSIGNED
MariaDB 中常用 INT UNSIGNED AUTO_INCREMENT 作主键，但 xorm 的 autoincr 标签默认生成有符号整型，强行映射会触发插入错误。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确写法：
Id int64 `xorm:"pk autoincr 'id'"`（显式指定列名，避免类型推断偏差） - 若数据库字段是
INT UNSIGNED，Go 结构体应使用uint64，并加xorm:"pk autoincr unsigned" -
xorm不识别gorm.Model这类嵌入结构，所有字段需显式声明 - 执行
engine.Sync2(&User{})时，若表已存在但字段类型不匹配（如 DB 是VARCHAR(100)，结构体 tag 写成varchar(50)），xorm默认不修改，也不会报错——静默忽略是常见坑点
gorm 自动迁移对 MariaDB 的 ENGINE=InnoDB 和字符集敏感
gorm 的 AutoMigrate 在 MariaDB 上默认建表用 ENGINE=InnoDB，但若数据库全局默认引擎是 Aria（某些 MariaDB 版本默认），表可能建出来却不支持外键或事务。
- 强制指定引擎：
db.Migrator().CreateTable(&User{})不够，得用db.Session(&gorm.Session{DryRun: true}).Migrator().GetDialect().GetName()判断后手动加 SQL hint - 更稳妥方式：在模型中用
gorm:"type:varchar(100);columnType:varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci" -
AutoMigrate不会修改已有列的字符集，比如表已用utf8，即使结构体 tag 写了utf8mb4，也不会升级——必须手工ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 - 外键约束在 MariaDB 中默认开启，但
gorm不自动生成FOREIGN KEYDDL，需额外调用db.Migrator().CreateConstraint
批量插入时 xorm 的 Insert 和 gorm 的 CreateInBatches 行为不同
MariaDB 对单次 INSERT 的参数数量有限制（max_allowed_packet），超限直接报错 ERROR 1390 (HY000): Prepared statement contains too many placeholders。
-
xorm的engine.Insert([]User{...})默认不分批，需手动切片 + 循环，或改用engine.InsertMulti（v1.2+ 支持） -
gorm的db.CreateInBatches(users, 100)会按每 100 条拆成独立 INSERT，但注意它不复用 prepared statement，高并发下可能打满连接数 - 两者都默认不返回插入后的主键 ID 数组；若需获取，
xorm要用engine.InsertOne单条循环，gorm得启用db.Session(&gorm.Session{FullSaveAssociations: true})并确保结构体 ID 字段可写 - 事务内批量插入失败时，
xorm报错后事务不会自动 rollback，必须显式session.Rollback()；gorm的Transaction函数会自动回滚，但前提是 panic 或返回 error
STRICT_TRANS_TABLES SQL mode 开启后，空字符串插入 NOT NULL 字段会直接报错，而 Go ORM 默认不校验零值。这个边界问题不在框架层体现，却常在上线后爆发——得靠建表时加 DEFAULT '' 或代码层预过滤。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
