Fiber 本身不管理数据库连接,真正建连入口是 sql.Open() 或 gorm.Open();必须显式配置连接池参数、校验 DSN、设置 SetConnMaxLifetime,否则上线必现 dial tcp: i/o timeout 或连接耗尽。

直接说结论:Fiber 本身不碰数据库连接,sql.Open() 和 gorm.Open() 才是真正建连的入口;不配连接池、不校验 DSN、不设 SetConnMaxLifetime,上线后必出 dial tcp: i/o timeout 或连接耗尽。
怎么用 database/sql + mysql 驱动连 MySQL
这是最轻量、最可控的方式,适合不需要 ORM 抽象的场景。
- 必须空白导入驱动:
import _ "github.com/go-sql-driver/mysql",漏掉这行会报sql: unknown driver "mysql" - DSN 格式要严格:
user:pass@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local,&是 HTML 实体,不是&字符;parseTime=true缺失会导致time.Time字段扫描为nil -
sql.Open()不真连,只做配置解析;必须跟db.Ping()才能确认通路是否畅通 - 全局持有一个
*sql.DB,别在 handler 里反复sql.Open()——否则快速触发too many open files
怎么用 GORM 连 MySQL(推荐用于业务逻辑复杂项目)
GORM 是封装层,底层仍走 database/sql,但省了手写 SQL 和 Scan 的体力活;注意它不自动帮你管连接池。
- 装对驱动:
go get gorm.io/gorm gorm.io/driver/mysql,别用已归档的github.com/jinzhu/gorm - 初始化后立刻调这些方法,否则默认值极危险:
db.DB().SetMaxOpenConns(50)、db.DB().SetMaxIdleConns(10)、db.DB().SetConnMaxLifetime(5 * time.Minute) -
SetConnMaxLifetime单位是time.Duration,写成"5m"会编译失败;值必须小于 MySQL 的wait_timeout(云 RDS 常为 300 秒) - DSN 中的
parseTime=True要大写T,小写会静默失效;loc=Local才能正确处理时区
常见错误现象和对应检查点
很多“连不上”问题其实不是网络或权限,而是配置错位或生命周期失控。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
立即学习“go语言免费学习笔记(深入)”;
- 报
invalid connection或查询返回空数据:大概率是SetConnMaxLifetime设得比数据库wait_timeout大,连接被服务端主动断开后复用失败 - 压测时大量
dial tcp: i/o timeout:MaxOpenConns=0(无上限)+ 高并发 → 瞬间打爆连接数,或 DNS 解析阻塞 - 本地连得上、Docker/K8s 里连不上:DSN 写死
localhost,容器内没这个 host;换成服务名(如mysql)或宿主机网关 IP - 时间字段全为零值:
parseTime=true拼错、漏写,或 DSN 里用了&而非&导致参数截断
DSN 怎么安全组装,避免硬编码密码
把密码明文写进代码再提交 Git,等于给攻击者送钥匙。
- 用环境变量拼接:读
os.Getenv("DB_USER")、os.Getenv("DB_PASS")等,再用fmt.Sprintf组成 DSN - 开发时用
.env文件,上线用 K8s Secret 或云厂商密钥管理服务(如 AWS Secrets Manager) - 千万别用字符串拼接用户输入进 DSN——哪怕只是调试,也埋下注入隐患
- PostgreSQL 和 MySQL 的 DSN 格式差异极大,换库时不能只改驱动,必须重审整个 DSN 字符串
最易被忽略的一点:连接池参数不是“设了就完事”,而要结合压测结果调。比如 SetMaxOpenConns 设太高,MySQL 侧可能因线程数超限拒绝新连接;设太低,又会在高峰期排队等待。上线前务必用 ab 或 hey 对真实接口压测,并观察 SHOW STATUS LIKE 'Threads_connected'。

















