Gin不控制SQL预编译，根本原因是MySQL驱动默认开启interpolateParams=true导致参数拼接绕过预编译；必须显式设置interpolateParams=false，并配合连接池合理配置与ORM正确用法才能生效。
预编译（Prepared Statement）本身在 database/sql 层由驱动自动管理，Gin 框架不参与也不控制 SQL 预编译逻辑；真正影响性能的是你用 Gorm 还是原生 sql.DB，以及是否触发了预编译复用、是否规避了隐式重编译。优化重点不在 Gin，而在数据库访问层的写法和配置。
为什么Gin里写的SQL没被预编译？
常见现象：明明用了 db.Query("SELECT * FROM users WHERE id = ?", id)，但慢查询日志里仍看到大量 Prepare + Execute 交替出现，甚至 QPS 上去后 MySQL 的 Com_prepare 计数飙升。
- 根本原因不是 Gin，而是底层 driver（如
go-sql-driver/mysql）默认开启interpolateParams=true（或等效行为），它会把参数拼进 SQL 字符串再发给 MySQL，绕过预编译 —— 这在高并发下等于每条语句都当新 SQL 处理 - Gorm v2 默认启用
PrepareStmt: true，但若你混用db.Raw("...").Scan()或手动拼接字符串，就直接退化为非预编译路径 -
sql.DB的预编译复用依赖连接复用和语句缓存，而连接池配置不当（如SetMaxOpenConns(1)）会导致每次请求换连接，无法命中缓存
MySQL驱动必须关闭参数插值
对 go-sql-driver/mysql，必须显式禁用客户端参数插值，否则所有 Query/Exec 调用都会跳过预编译：
dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?interpolateParams=false"
db, err := sql.Open("mysql", dsn)
-
interpolateParams=false是硬性要求，不加这参数，哪怕你写WHERE id = ?，驱动也会替换成WHERE id = 123再发过去 - PostgreSQL 用户用
pgx则天然走预编译（pgx.Conn.Exec()底层始终调用Parse+Bind+Execute），无需额外开关 - SQLite 驱动（
mattn/go-sqlite3）也默认支持，但要注意CacheSize和JournalMode配置影响复用效率
Gorm 中如何确保预编译生效
Gorm 自带预编译开关，但容易被误关或绕过：
- 初始化时明确启用：
gorm.Open(mysql.Open(dsn), &gorm.Config{PrepareStmt: true})（v2 默认为true，但某些旧版或自定义 dialector 可能未继承） - 避免使用
db.Raw()+ 字符串拼接：db.Raw("SELECT * FROM users WHERE name = '" + name + "'")→ 完全绕过预编译，且有 SQL 注入风险 - 慎用
Session(&gorm.Session{PrepareStmt: false})：全局设了PrepareStmt: true，但某次查询临时关掉，就会单条退化 - 检查日志：开启 Gorm 日志（
logger.Default.LogMode(logger.Info)），看到[1.2ms] [rows:5] SELECT * FROM users WHERE id = ?表示走了预编译；若看到SELECT * FROM users WHERE id = 123，说明已被插值替换
连接池配置直接影响预编译复用率
预编译语句（PreparedStatement）绑定在单个数据库连接上，连接被归还到池中后，该语句对象通常仍保留在连接内（取决于驱动实现），下次从池中取出同一连接就能复用。
-
db.SetMaxOpenConns(100)：太小（如5）会导致连接争抢，请求频繁换连接，预编译缓存命中率暴跌 -
db.SetMaxIdleConns(20)：空闲连接数太少，连接很快被回收，预编译语句随连接销毁而丢失 -
db.SetConnMaxLifetime(1h)：合理设置，避免连接长期存活导致内存泄漏，但也不要设成5m——刚缓存好语句就销毁连接 - 实测建议：
MaxOpenConns ≈ QPS × 平均查询耗时（秒）× 1.5，例如 2000 QPS × 0.05s × 1.5 ≈ 150
预编译不是“开了就快”，它依赖驱动行为、连接生命周期、SQL 写法三者协同；最容易被忽略的是 interpolateParams=false 这个开关——没它，其他所有配置都是白搭。
