sql.Open仅校验DSN格式不建连,db.Ping()才发起TCP握手并验证鉴权;生产环境需配bind-address=0.0.0.0、skip-name-resolve、防火墙放行3306,并设parseTime=true与合理连接池参数。

生产环境必须用 go build 编译二进制 + systemd 托管,go run main.go 只能用于本地调试。
为什么 sql.Open 不报错但 db.Ping() 会失败
因为 sql.Open 只校验 DSN 字符串格式,不建立真实连接;db.Ping() 才真正发起 TCP 握手并验证鉴权。生产部署中常见现象是:DSN 里写 localhost,本地能通,上服务器就 Ping: dial tcp 127.0.0.1:3306: connect: connection refused——本质是 MySQL 默认绑定 127.0.0.1,而容器或远程服务器需改用宿主机 IP 或 0.0.0.0 监听,并确认 skip-name-resolve 已启用(否则 DNS 查询可能阻塞 30 秒)。
- DSN 中优先用
127.0.0.1替代localhost,绕过 Unix socket 和 DNS 解析 - MySQL 配置文件中必须有
bind-address = 0.0.0.0和skip-name-resolve = 1 - 防火墙要放行 3306 端口:
sudo ufw allow 3306(Ubuntu)或sudo firewall-cmd --add-port=3306/tcp --permanent(CentOS)
如何避免连接池耗尽和 time.Time 解析失败
Go 的 *sql.DB 是连接池抽象,不是单个连接。若没设 SetMaxOpenConns 和 SetConnMaxLifetime,高并发下会出现大量 Sleep 状态连接,MySQL 报 Too many connections,而 show processlist 显示活跃连接却很少。同时,MySQL 的 datetime 字段默认不带时区,若 DSN 缺少 parseTime=true&loc=Local,Scan() 到 time.Time 会返回零值或 panic。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 初始化后立即调用:
db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10)、db.SetConnMaxLifetime(60 * time.Second) - DSN 必须包含:
?parseTime=true&loc=Local(注意 & 是 HTML 实体,实际代码中写 &) - 别在 handler 里反复调
sql.Open,全局复用一个*sql.DB实例
为什么 Nginx 代理后出现 502 或长连接被截断
Gin 默认不设置 HTTP 超时,但 Nginx 的 proxy_read_timeout 默认仅 60 秒。若接口执行超时(比如慢查询、未加索引的全表扫描),Nginx 先断开连接,Gin 还在往已关闭的 socket 写响应,日志里就出现 upstream prematurely closed connection。更隐蔽的是长轮询或 SSE 场景,Nginx 默认启用了 proxy_buffering on,会缓存整个响应体再吐给客户端,导致流式数据卡住。
- Nginx 配置中加:
proxy_read_timeout 300(匹配你的最长业务耗时) - 对流式接口(如 /events)必须加:
proxy_buffering off和proxy_cache off - Gin 层建议显式设
engine.MaxMultipartMemory = 8 ,防大文件上传触发 OOM
最常被忽略的是:MySQL 的 wait_timeout(默认 28800 秒)和 Go 的 SetConnMaxLifetime 不匹配。如果后者设成 30 秒,但前者是 8 小时,连接池里的空闲连接会在 MySQL 主动 kill 后,下次复用时报 invalid connection —— 这类错误不会立刻暴露,而是在流量波动时集中爆发。

















