数据库连接与查询常见问题怎么解决?,数据库连接失败如何排查?
数据库连接与查询出问题,八成跑不出三个地方:连接没释放、连接池配置偏小、查询缺索引。先数连接,再看慢查询,最后动配置,顺着这条线基本能找到根因。这篇是我自己踩坑后的整理,场景以个人博客和小型项目为主,命令和参数都能直接拿去试。
数据库连接报错,先别急着改代码
连接类报错看着吓人,其实信号很集中。先分清是哪一种,再决定往哪查。
几类典型信号对应什么问题
无序列表过一遍:
– `Connection refused`:端口没通,服务没起,或者防火墙拦了。先 `telnet 127.0.0.1 3306` 试一下。
– `Communications link failure`:TCP 能连上但握手断了,常见于 SSL 配置、超时时间设得太短、中间有代理。
– `Too many connections`:数据库侧连接数到顶了,`max_connections` 撑不住。
– `Connection is not available, request timed out`:这是应用侧连接池的报错,池子里的连接被借光了,等不到。
前两个偏网络和服务端,后两个偏应用侧。分清楚了,排查范围能砍掉一半。
数据库连接池耗尽怎么解决:先数连接,再看代码
我遇到 `Too many connections` 的第一反应是调大 `max_connections`,这是治标。正确顺序是这样:
1. 看当前连接数:`SHOW STATUS LIKE ‘Threads_connected’;`
2. 看上限:`SHOW VARIABLES LIKE ‘max_connections’;`
3. 看谁占着:`SHOW PROCESSLIST;` 重点盯 `Sleep` 状态且 `Time` 很长的连接。如果一堆 Sleep 几百秒的连接,基本就是泄漏。
4. 应用侧翻代码:每个 `getConnection()` 是不是都有对应的 `close()`。Java 用 try-with-resources,Python 用 `with`,Go 用 `defer rows.Close()`。异常分支最容易漏。
5. 检查连接池的 `maxLifetime` 是不是大于数据库的 `wait_timeout`。服务端先把空闲连接踢了,客户端还以为它活着,拿出去用就报错。
第 5 条很多人忽略。MySQL 默认 `wait_timeout` 是 28800 秒,连接池默认 `maxLifetime` 往往也是 30 分钟,两个值贴得太近就容易出问题。把池的 `maxLifetime` 设成比 `wait_timeout` 小几十秒,能省掉一批偶发报错。
查询慢和连接超时,是两回事
这两个经常被混着说,但排查路径完全不同。连不上和连上了等结果,是两种病。
MySQL连接超时和查询慢的区别在哪里
用表格对比更直观:
| 维度 | 连接超时 | 查询慢 |
|---|---|---|
| 现象 | 请求发不出去,或握手阶段断开 | 连上了,但结果迟迟不回 |
| 典型报错 | `Can't connect to MySQL server`、`connect timed out` | 无报错,接口响应时间变长 |
| 首查位置 | 网络、端口、防火墙、`max_connections`、DNS | 慢查询日志、`EXPLAIN`、锁等待 |
| 常用命令 | `telnet`、`SHOW PROCESSLIST` | `SHOW FULL PROCESSLIST`、`EXPLAIN` |
| 常见原因 | 服务没起、连接数满、超时值太小 | 缺索引、索引失效、返回行太多、锁冲突 |
分不清的时候,看接口日志里有没有拿到连接。拿到了就是查询问题,没拿到就是连接问题。
数据库查询慢是什么原因导致的
按我遇到的频率排个序:
– 没索引。最常见。`WHERE` 条件字段上没有索引,全表扫。
– 索引失效。字段上套了函数、发生隐式类型转换(字符串字段传了数字)、`LIKE ‘%xxx’` 前导通配。
– 返回行数太多。分页没做好,一次捞几万行,网络传输和内存都扛不住。
– 锁等待。有长事务占着行锁,后面的查询排队。
– 排序和临时表。`ORDER BY` 字段没索引,或者 `GROUP BY` 产生大临时表。
定位手段就一个:开慢查询日志。`long_query_time` 设成 1 或 2 秒,跑几天看看哪些 SQL 上榜。单条 SQL 用 `EXPLAIN` 看执行计划,重点看 `type` 是不是 `ALL`(全表扫)、`key` 是不是 NULL、`rows` 估算多少、`Extra` 里有没有 `Using filesort` 或 `Using temporary`。MySQL 8.0.18 以后可以用 `EXPLAIN ANALYZE`,直接看真实耗时,比估算值靠谱。
业内专家指出,大部分慢查询的修复成本远低于加机器,先把索引补上再谈扩容。
本地开发数据库连接报错怎么排查
本地环境的坑和线上不一样,列几个我踩过的:
– `localhost` 和 `127.0.0.1` 在部分系统上走不同协议,一个走 socket 一个走 TCP。容器里连宿主机的库,用 `127.0.0.1` 往往连不上,得用宿主机的实际 IP 或 `host.docker.internal`。
– MySQL 的 `bind-address` 默认是 `127.0.0.1`,只监听本地。容器要连就得改成 `0.0.0.0`,但别在公网机器上这么干。
– Docker 端口映射写错,`-p 3306:3306` 漏了或者宿主端口被占用。
– 时区不一致导致数据看着不对,连接串加 `serverTimezone` 参数。
排查就三步:`telnet` 看端口通不通,`mysql -h 127.0.0.1 -P 3306 -u root -p` 看客户端能不能连,再不行看容器日志。
连接池参数怎么调才不踩坑
参数不是越大越好。池子开太大,数据库那边先崩;开太小,应用线程排队。
几个关键参数的实际含义
以 HikariCP 为例,其他池子命名不同但逻辑相通:
| 参数 | 作用 | 设置思路 |
|---|---|---|
| `maximumPoolSize` | 池里最多几个连接 | 所有应用实例加起来不能超过数据库 `max_connections` 的七八成 |
| `minimumIdle` | 最少保留几个空闲连接 | 和 `maximumPoolSize` 设成一样,避免频繁扩缩 |
| `connectionTimeout` | 拿连接最多等多久 | 设 3 到 5 秒,太久会让请求堆积 |
| `idleTimeout` | 空闲连接多久回收 | 小于数据库 `wait_timeout` |
| `maxLifetime` | 连接最长活多久 | 比 `wait_timeout` 小 30 秒左右 |
| `keepaliveTime` | 保活探测间隔 | 有中间代理或防火墙时开起来 |
池子大小的起始值,行业共识认为可以按 `(CPU核数 × 2) + 有效磁盘数` 估,但这是老经验,实际得压测。看两个指标:等待获取连接的时长、数据库 CPU 使用率。等待时间长说明池子小,数据库 CPU 先满说明池子大或者查询本身有问题。
线上和本地别用同一套配置
本地开发我故意把池子调小,比如 `maximumPoolSize=5`。连接泄漏在本地更容易暴露,跑几个请求就报错,比线上半夜报警强。线上按并发量给,同时把监控挂上,活跃连接数和获取连接的等待时间这两个指标最有用。
个人项目里的选型和日常习惯
个人项目数据库选MySQL还是PostgreSQL
这个问题我在搭博客时纠结过。结论是看用途:
– 博客、小工具、后台管理这类读写简单、数据量不大的,MySQL 够用,托管服务多、便宜、教程也多。
– 需要复杂查询、JSON 字段、地理数据、严格约束的,PostgreSQL 更顺手,语法上更接近标准 SQL。
两边都有免费额度可用,真拿不准就先用 MySQL 跑起来,迁移成本没想象中高。
几个顺手的小习惯
– 连接串统一走环境变量,别写死在代码里。
– 用了 ORM 也要看它生成的 SQL,`EXPLAIN` 一遍心里才有底。
– 慢查询日志常开,阈值别设太高。
– 定期 `SHOW PROCESSLIST` 瞄一眼,Sleep 连接突然变多就是警报。
– 备份脚本别只写在待办里。
数据库连接与查询常见问题Q&A
连接池设多大合适?
先算数据库侧的上限:`max_connections` 减去预留的运维连接,再除以应用实例数,就是每个池子的天花板。起始值按 CPU 核数估一个,然后压测看获取连接的等待时间,持续超过几十毫秒就往上加,数据库 CPU 先打满就反过来减。
报Too many connections但业务量不大,怎么回事?
多数是连接泄漏,不是量的问题。查 `SHOW PROCESSLIST` 里状态为 Sleep 且时间很长的连接,再看应用里异常分支有没有漏 `close()`。还有一种情况是 `maxLifetime` 大于数据库 `wait_timeout`,服务端断开的连接客户端还在复用。
EXPLAIN看着走了索引,为什么还是慢?
看三处:`rows` 估算和实际返回差多少、`Extra` 有没有 `Using filesort` 或 `Using temporary`、有没有回表次数过多。锁等待也会让执行计划看着正常但实际卡住。MySQL 8.0.18 以上直接跑 `EXPLAIN ANALYZE`,拿到的真实耗时比估算值更能说明问题。
数据库连接和查询的排查,顺序比技巧重要:先确认连接拿没拿到,再判断是等结果还是等连接,最后才动配置和索引。多数问题在第一步和第二步就能定位,剩下的是参数微调和习惯养成。