Go程序连不上MySQL，90%是MySQL未启动、端口未开放或用户权限不足；需检查bind-address、防火墙、创建专用用户并授权；使用database/sql+驱动，显式设连接池与超时参数，敏感信息用环境变量注入。
确认 MySQL 服务已就绪且可访问
Go 程序连不上数据库，90% 的情况不是代码问题，而是本地或远程 MySQL 实例根本没启动、没开放端口、或用户权限不足。mysql -u root -p 能登录，只说明命令行客户端通；Go 程序用的是 TCP 连接，必须额外验证网络层是否放行。
- 检查 MySQL 是否监听
0.0.0.0:3306（而非仅127.0.0.1:3306）：查看my.cnf中bind-address配置，生产环境慎用0.0.0.0，开发可临时设为该值 - 确认防火墙允许 3306 端口：Linux 上运行
sudo ufw status或sudo iptables -L；Docker 容器需加-p 3306:3306 - 创建专用连接用户（别直接用 root）：
CREATE USER 'appuser'@'%' IDENTIFIED BY 'strong-pass-123';
GRANT SELECT, INSERT, UPDATE, DELETE ON mydb.* TO 'appuser'@'%';
FLUSH PRIVILEGES;
选择并初始化 database/sql + 驱动
Go 原生只提供 database/sql 接口，不包含具体实现。必须显式导入第三方驱动（如 github.com/go-sql-driver/mysql），且需在程序启动时调用 sql.Open —— 它**不真正建连**，只是准备连接池配置。
- 安装驱动：
go get -u github.com/go-sql-driver/mysql -
sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local")中的parseTime=true是关键，否则TIME/DATETIME字段会转成字符串；loc=Local避免时区错乱（若 DB 用 UTC，此处应为loc=UTC） - 务必调用
db.Ping()主动测试连接，否则首次查询失败才暴露问题
管理连接池与超时参数
默认连接池行为极易引发线上问题：空闲连接不释放、并发突增时连接数暴涨、慢查询拖垮整个服务。所有超时都得显式设，不能依赖驱动默认值。
-
db.SetMaxOpenConns(25)：控制最大打开连接数，建议设为应用预期并发请求数的 1.5–2 倍 -
db.SetMaxIdleConns(10)：空闲连接上限，避免长期占用 DB 资源；设太小会导致频繁建连/销毁开销 -
db.SetConnMaxLifetime(3 * time.Hour)：强制回收老化连接，防止 DB 侧因 wait_timeout 断连后 Go 还在复用 - 单次查询超时用
context.WithTimeout包裹，例如：ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
rows, err := db.QueryContext(ctx, "SELECT ...")
敏感信息不硬编码，用环境变量注入
把密码写死在代码或 config 文件里，等于把钥匙贴在门上。Go 没有内置 dotenv 支持，但可用标准库 os.Getenv 安全读取，配合 CI/CD 注入或本地 .env 文件（由部署脚本加载）。
立即学习“go语言免费学习笔记（深入）”；
- 连接字符串拼接示例：
dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?parseTime=true&loc=Local",
os.Getenv("DB_USER"),
os.Getenv("DB_PASS"),
os.Getenv("DB_HOST"),
os.Getenv("DB_PORT"),
os.Getenv("DB_NAME")) - 本地开发时，用
export DB_PASS="xxx"设置；Kubernetes 中通过Secret挂载环境变量；Docker Compose 用environment或env_file - 切勿用
log.Printf打印完整dsn，密码字段必须脱敏（如只显示user:***@tcp(...)）
实际跑通的关键，往往卡在 MySQL 的 bind-address 和用户 host 匹配规则上——'appuser'@'localhost' 和 'appuser'@'127.0.0.1' 在 MySQL 里是两个不同账号，本地 Go 程序走 TCP 连接时，host 解析结果可能是后者。
