Revel 初始化时需在 app/init.go 的 init() 或 AppInit() 中显式创建多个 *gorm.DB 实例(如 DBMaster、DBShard1),导入 "gorm.io/driver/mysql",使用 URL 格式 DSN(含 charset=utf8mb4&parseTime=True&loc=Local),并执行连通性验证。

Revel 初始化时如何配置 GORM 连接 MySQL
Revel 本身不内置 ORM,必须手动集成 GORM(推荐 v2+);连接不是靠配置文件自动加载,而是在 app/init.go 的 init() 或 AppInit() 函数中显式初始化 *gorm.DB 实例。
关键点是:不能复用同一个 *gorm.DB 变量去“切换”数据库,而应预建多个实例(如主库、分片库),再按需注入请求上下文。否则会引发连接池竞争、事务混乱或 context cancel 泄漏。
- 导入驱动:
"gorm.io/driver/mysql"(或postgresql/sqlite) - DSN 格式必须为 URL 形式,例如:
"user:pass@tcp(127.0.0.1:3306)/mydb?charset=utf8mb4&parseTime=True&loc=Local"—— 注意&是 HTML 实体,Go 字符串里要写成& - 务必调用
DB.Exec("SELECT 1")或DB.Migrator().CurrentDatabase()做启动时连通性验证,否则失败静默,直到第一次查询才 panic
如何把 GORM 实例安全传入 Controller
Revel 的 Controller 是每次请求新建的,不能直接在结构体里存 *gorm.DB,否则无法做连接路由或分库。正确做法是通过 revel.InterceptFunc 注入到 c.Params.Values 或自定义字段。
常见错误是直接在 App 结构体里加 DB *gorm.DB 字段并全局赋值 —— 这会导致所有请求共享同一连接池,失去分库/读写分离能力,且并发下 Session 配置互相污染。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 在 filter 中绑定:
c.Params.Set("db", DBMaster),然后 Controller 里用c.Params.Get("db").(*gorm.DB)取出 - 若需动态选库(如按用户 ID 分片),filter 内应解析
c.Request.URL.Query().Get("shard")或从 token 提取 tenant_id,再查表或哈希映射到对应*gorm.DB实例 - 避免在 filter 中执行耗时操作(如查路由表),建议预热缓存或用 sync.Map 存 shard → DB 映射
Controller 中读写数据的典型写法
不要在 Controller 方法里反复调用 gorm.Open(),也不要用 db.Session(&gorm.Session{...}) 包裹整段逻辑 —— Session 是轻量上下文,但滥用会导致事务隔离失效或 Preload 错乱。
实际读写应聚焦在模型方法内完成,Controller 只负责协调输入输出。GORM 的链式调用不是线程安全的,每个请求必须用独立的 *gorm.DB 实例(即从上下文取出的那个)。
- 查询单条:
err := c.Params.Get("db").(*gorm.DB).First(&user, "id = ?", id).Error - 插入带主键:
result := db.Create(&user); if result.Error != nil { ... };注意Create不会自动返回自增 ID 到 struct,除非字段有gorm:"primaryKey;autoIncrement"tag - 事务控制必须显式开始:
tx := db.Begin(); defer func() { if r := recover(); r != nil || tx.Error != nil { tx.Rollback() } }(); tx.Commit()—— Revel 没有自动事务拦截器
容易被忽略的字符集与时间处理问题
MySQL 默认 utf8 实际只支持 3 字节 UTF-8 字符(不包括 emoji),而 Revel + GORM 组合若没在 DSN 里强制指定 charset=utf8mb4,入库中文可能变 ???,且无法被 LIKE 正确匹配。
另外,Go 的 time.Time 默认序列化为本地时区,但 MySQL 的 DATETIME 无时区信息。如果服务器和应用时区不一致,created_at 字段会出现数小时偏差。
- DSN 必须含:
charset=utf8mb4&parseTime=True&loc=Local(loc=UTC也可,但需全栈统一) - 模型字段声明推荐显式指定:
CreatedAt time.Time `gorm:"column:created_at;autoCreateTime"`,避免依赖默认行为 - 测试时用
SELECT @@character_set_database, @@collation_database确认库级编码,别只看表或列
maxIdleConns / maxOpenConns 未调优)、DNS 缓存导致主从 IP 切换失败、以及 GORM 日志开关没关导致 I/O 阻塞。这些不会报错,只会让接口延迟陡增。

















