TiDB完全兼容MySQL协议，Gin整合TiDB与MySQL一致，无需专用驱动；只需正确配置DSN（如parseTime=True、loc=Asia/Shanghai等），GORM等库可直连，但需注意AutoMigrate限制、乐观事务重试及分布式冲突处理。
Gin 框架本身不绑定任何数据库，整合 TiDB 和整合 MySQL 几乎完全一致——因为 TiDB 兼容 MySQL 协议，GORM、sqlx、database/sql 等 Go 生态主流库都能直接用，无需额外适配或特殊驱动。
为什么不用换驱动？
TiDB 是 MySQL 协议兼容的分布式数据库，只要连接字符串（DSN）指向 TiDB 的 MySQL 兼容端口（默认 4000），所有基于 mysql 驱动的 Go 库都可直连。GORM 的 gorm.io/driver/mysql 就是标准选择，别被“TiDB”名字唬住。
-
TiDB不需要专用 Go driver；强行找 “tidb-go” 或 “tidb-driver” 反而可能引入非官方、维护停滞的包 - DSN 格式与 MySQL 完全一致：
user:pass@tcp(127.0.0.1:4000)/dbname?charset=utf8mb4&parseTime=True&loc=Local - 连接池行为、超时设置、事务语义全部沿用 MySQL 原有逻辑，无隐藏差异
初始化 GORM 连接 TiDB 的关键参数
虽然协议兼容，但 TiDB 有自己偏好的连接配置，否则容易在高并发或长事务场景下出错：
- 必须启用
parseTime=True：TiDB 的TIMESTAMP字段返回带时区信息的字符串，不解析会 panic - 推荐设置
timeout=5s&readTimeout=15s&writeTimeout=15s：TiDB 默认读写超时较宽松，Go 客户端需主动约束，避免 goroutine 泄漏 -
loc=Asia/Shanghai比loc=Local更稳妥：TiDB server timezone 通常设为 CST，硬绑定本地时区可能导致时间错位 -
autoCommit=False（可选）：TiDB 的乐观事务模型对显式事务更友好，关闭自动提交便于控制Begin/Commit/Rollback
dsn := "root:@tcp(127.0.0.1:4000)/testdb?charset=utf8mb4&parseTime=True&loc=Asia/Shanghai&timeout=5s&readTimeout=15s&writeTimeout=15s"
GORM AutoMigrate 在 TiDB 上的限制
AutoMigrate 能建表、加字段、改类型，但在 TiDB 上要格外注意：
- 不支持修改主键（
ALTER TABLE ... DROP PRIMARY KEY）、不支持删除列（TiDB 5.2+ 才支持DROP COLUMN，且需开启alter-primary-key配置） -
TEXT/MEDIUMTEXT字段不能设默认值（TiDB 报错：ERROR 1101 (HY000): BLOB/TEXT column 'xxx' can't have a default value） - 建议首次建库用 SQL 脚本（如
CREATE TABLE），后续字段变更走人工 SQL + 版本化 migration，别全依赖AutoMigrate - 若必须用
AutoMigrate，先检查 TiDB 版本：SELECT tidb_version();，5.0+ 较稳，4.x 对索引和约束支持较弱
事务与冲突处理要手动应对
TiDB 使用乐观锁，INSERT ... ON DUPLICATE KEY UPDATE 或 REPLACE INTO 会触发重试逻辑，但 GORM 默认不重试。常见现象是：
- 并发插入唯一键冲突时，GORM 报
ErrDuplicatedKey，但实际数据可能已写入（因 TiDB 已执行并回滚） -
Save()在高并发下偶发WriteConflictError（错误码9007），需业务层捕获并重试
建议封装一个带重试的保存函数：
func SaveWithRetry(db *gorm.DB, obj interface{}, maxRetries int) error {
for i := 0; i <= maxRetries; i++ {
err := db.Save(obj).Error
if err == nil {
return nil
}
if errors.Is(err, gorm.ErrDuplicatedKey) || strings.Contains(err.Error(), "9007") {
if i == maxRetries {
return err
}
time.Sleep(time.Millisecond * 10 * time.Duration(i+1))
continue
}
return err
}
return nil
}TiDB 的分布式本质决定了它不会像单机 MySQL 那样“静默覆盖”，冲突必须由应用感知和决策。这点最容易被忽略。
