这是一份写给未来自己的线上问题备忘录,也希望能帮到下一个在凌晨被告警叫醒的你。每篇都按同一个套路写:现象 → 排查路线图 → 命令与输出 → 根因 → 止血 → 根治 → 复盘,命令能直接复制,图能直接看懂。
说明:这些案例综合了我自己踩过的坑,以及公开的技术复盘和官方文档,再按第一人称重新讲述;涉及公司、客户、内网的信息全部做了脱敏或改写,文中的 IP、订单号、手机号都是示例值。命令与原理都对照资料核对过,示例输出按真实格式编写,具体数字仅用于说明量级。发现错误欢迎留言。
先看地图:问题在哪一层?
① 入口层 证书过期 · Nginx 502/504 · 413 与 WebSocket 断连 ② 服务治理层 Dubbo 超时重试 · Nacos 配置与注册中心 · XXL-JOB · 链路追踪 ③ 应用进程层 CPU 飙高 · OOM · Full GC · 线程池 · 堆外内存 · 死锁 · Arthas ④ 数据与消息层 慢 SQL · 死锁 · MDL · 主从延迟 · 连接池 · Redis · MQ 堆积与重复 ⑤ 机器与容器层 磁盘 · 负载 · OOM Killer · 句柄 · 挖矿木马 · cron · Docker 全家桶
口诀:由外到内、逐层排除。用户说“慢”,先看入口有没有报错,再看服务有没有超时,然后是进程、数据、机器;每一层只用一两条命令,别一上来就怀疑人生。
症状速查
全部文章(按分类)
Java / JVM 排查(7 篇)
CPU 飙到 800%:一条“无辜”的正则,把 8 核机器吃得只剩渣
告警说 Java 进程 CPU 800%,接口全部超时。top -Hp → printf 转十六进制 → jstack,三步定位到一条正则的灾难性回溯。附完整命令、根因分析和三种修法。导出 50 万行报表,堆直接原地去世:一次 OOM 的 dump 分析与流式改造
运营点了一下“导出全部订单”,服务就抛出 Java heap space 并重启。靠 HeapDumpOnOutOfMemoryError 留住现场,用 MAT 的 Dominator Tree 揪出一个 List,最后改成分页 + EasyExcel 流式写出。接口“偶发”卡 3 秒?它其实很准时:一次 Full GC 频繁的追凶记
接口 P99 隔几分钟就冲到 3 秒,机器 CPU 却不高。开 GC 日志、jstat 看趋势,发现老年代被一个无界的静态 Map 缓存慢慢撑满,Full GC 越来越频繁。附 JDK8 与 JDK11+ 日志参数、G1 与 CMS 取舍。下游慢 2 秒,上游全挂:一次线程池被打满的连环追尾
积分服务变慢,订单服务接口全部超时,CPU 却只有 5%。jstack 看到 200 个 Tomcat 线程都阻塞在 socket read 与连接池里,根因是没设超时、队列无界、没有隔离。附拒绝策略与超时、舱壁隔离的落地写法。堆明明没满,容器却被 OOMKilled:一个 ByteBuf 忘了 release 的堆外内存漏洞
消息推送网关的堆使用率一直只有 40%,容器 RSS 却每天涨一截,最后被 OOMKilled,日志里还偶发 Direct buffer memory。用 NMT、Netty 泄漏检测 PARANOID 找到忘记 release 的 ByteBuf,并给堆外内存加上限。应用“假死”:CPU 2%,请求全挂,jstack 一眼看出两个线程在互相“谦让”
服务进程在、端口通、健康检查也过,但所有业务请求都卡住,CPU 只有 2%。jstack 直接报出 Found one Java-level deadlock。本文含最小可复现代码、输出逐行解读,以及锁顺序统一、tryLock 超时、缩小锁粒度三种修法。不重启、不改代码:用 Arthas 现场揪出“偶发 3 秒”的那一次调用
商品详情接口每隔几十次就慢 3 秒,日志里什么都没有。用 Arthas 的 dashboard、thread、trace、watch、stack 逐层下钻到一个连不上的备用节点,再用 jad、redefine 临时止血,最后用 profiler 火焰图复核。
数据库与缓存排查(8 篇)
明明建了索引,SQL 却跑成了全表扫描:隐式转换、函数包裹与字符集的“四连暗杀”
一条上线半年都很快的 SQL 突然变慢,EXPLAIN 显示 type=ALL。从慢日志、pt-query-digest 到 EXPLAIN 逐列解读,逐个排查隐式类型转换、函数包裹列、前导 % 与字符集不一致导致索引失效,并给出改法。“Deadlock found when trying to get lock”:两个事务互相谦让,谁也没让成
业务偶发报 MySQL 1213 死锁,几百单里才一两单。用 SHOW ENGINE INNODB STATUS 逐行读懂 LATEST DETECTED DEADLOCK,配合 innodb_print_all_deadlocks 复现两类典型死锁:相反顺序加锁与间隙锁,并给出重试和统一加锁顺序的治法。给大表加一个字段,整站查询全卡死:一个“睡着”的事务与 Waiting for table metadata lock
线上执行 ALTER TABLE 加字段,结果这张表所有读写全部排队。原因是一个没提交的长事务持有 MDL 读锁,ALTER 等写锁,后续请求全被堵在队列。附 processlist、performance_schema、sys 视图定位与 kill、Online DDL、gh-ost、lock_wait_timeout 的做法。刚下的单,转头就查不到:读写分离、主从延迟与那个 500 万行的 DELETE
读写分离上线后,用户“下单成功却看不到订单”。用 SHOW REPLICA STATUS 看 Seconds_Behind_Source,定位到大事务与单线程回放,再讲并行复制、Canal 延迟排查,以及“读自己写的”几种落地方案。HikariPool-1 - Connection is not available:连接池被“借了不还”的事务掏空了
接口大面积报 Connection is not available, request timed out after 30000ms。用 Hikari 日志、show processlist 与 jstack 交叉验证,找出事务里调远程接口占着连接的元凶,并讲清 maximumPoolSize 的公式、leakDetectionThreshold 与指标告警。月初报税高峰,热点 key 同时“下班”:缓存击穿把 MySQL 打成了 PPT
月初征期一到,一批热点 key 在同一秒过期,请求全部回源,MySQL 连接数瞬间打满。从命中率与 QPS 曲线定位击穿,辨析穿透/击穿/雪崩,并给出互斥锁、逻辑过期、随机 TTL、布隆过滤器与多级缓存的落地写法。Redis 隔几分钟“抽风”一次:一个 200 万字段的 Hash,拖着全公司业务一起卡
Redis 没宕机、CPU 也不高,却隔几分钟整体卡顿,别的业务跟着超时。用 SLOWLOG、latency doctor、--bigkeys / --memkeys、MEMORY USAGE 揪出一个大 Hash 和一条 HGETALL,附 UNLINK、SCAN、拆 key 的完整修法。分布式锁“锁了个寂寞”:任务跑得比锁久,两台机器同时扣了一笔款
同一笔账被两个实例同时处理,锁明明加了。从 redis-cli 现场查锁 key 与 TTL 入手,讲清锁过期自动释放、误删他人锁、Redisson 看门狗只在不传 leaseTime 时续期、unlock 抛 IllegalMonitorStateException,以及主从切换丢锁与 Redlock 争议。
消息队列排查(3 篇)
“怎么还没收到短信?”RocketMQ 堆了 300 万条消息,我从 Diff Total 一路追到一个死循环重试
用户投诉验证码半小时没到,RocketMQ 短信 Topic 堆积 300 万。用 mqadmin consumerProgress / consumerConnection / topicStatus 判断是消费慢还是消费者掉线,定位到线程卡在下游接口与失败无限重试,并给出扩容、批量消费、死信与跳过历史消息的处置。用户收到两条短信,另一位用户的扣款却“查无此消息”:MQ 重复与丢失的双面案件
同一天两起投诉:验证码收到两条、一笔扣款没有对应的消息。以 RocketMQ 为主,讲清 at-least-once 下重复消费的根源(超时重投、重平衡、重试),落地唯一键/去重表/状态机/SETNX 幂等;再沿生产端、Broker、消费端三环节查丢消息并给出配置。RabbitMQ 的 Unacked 越攒越多,连接还被 blocked 了:一条忘了 ack 的消息引发的血案
管理界面里 Unacked 涨到 12 万,内存水位告警、生产者连接被 blocked。用 rabbitmqctl list_queues / list_channels / list_connections 定位忘记 ack 的消费者,讲清 prefetch、内存与磁盘水位流控、死信与 TTL,并给出止血与根治配置。
服务器与 Linux 排查(6 篇)
df 说磁盘 100%,du 说只用了一半:被 rm 了却还“活着”的日志文件
磁盘告警 100%,du 加起来却只有一半。原来是日志被 rm 了,Java 进程还握着文件句柄。用 lsof +L1 找到它,/proc/PID/fd 截断止血,再顺带讲 inode 耗尽、大文件定位和 logrotate copytruncate。load average 飙到 60,CPU 却在摸鱼:一场由 D 状态进程引发的“假繁忙”
监控里 load 飙到几十,top 里 CPU 却几乎空闲。原来 Linux 的 load 也统计 D 状态进程。用 vmstat、iostat -x、pidstat -d、iotop 和 ps 找出是磁盘慢还是 NFS 卡死,并讲清 await 与 %util 怎么读。Java 进程“人间蒸发”:没有 hs_err、没有 OOM 异常,凶手是 Linux 的 OOM Killer
服务凌晨无声消失,没有 hs_err 文件也没有 OutOfMemoryError。dmesg 里一行 Out of memory: Killed process 揭开真相:JVM 堆加堆外内存把机器吃光,被内核枪毙。附排查命令、oom_score 原理和堆参数预留算法。Too many open files:一个没关的 HttpClient,攒出了三万个 CLOSE_WAIT
接口突然大面积报 Too many open files。先分清 ulimit、limits.conf、systemd LimitNOFILE 与容器的差异,再用 lsof、ss 统计连接状态,定位到 CLOSE_WAIT 堆积,根因是 HttpClient 响应没关闭导致连接泄漏。服务器 CPU 100%,罪魁是个名字很奇怪的进程:一次挖矿木马应急响应
top 里一个名字怪异的进程吃满 CPU,杀了又活。本文从防御视角复盘一次挖矿木马应急:定位进程、/proc/PID/exe、外连矿池、cron 与 authorized_keys 持久化、日志溯源,以及清理与加固清单。手敲能跑,放进 cron 就“装死”:定时任务没执行的八种死法
备份脚本手敲一切正常,放进 crontab 却悄无声息地不执行。逐条排查 cron 服务与日志、PATH 环境变量、百分号转义、时区、权限、输出重定向、flock 防重叠、时间漂移,并对比 XXL-JOB。
Docker 与容器排查(5 篇)
容器每 40 秒“重生”一次:Restarting、exit 137 与一场 restart always 引发的重启风暴
docker ps 里一个容器永远显示 Restarting,日志什么都没有。docker inspect 看 OOMKilled 与 ExitCode 137,配合 docker events、stats、dmesg 定位内存超限,讲清 restart policy 如何放大故障、-m 与 swap 的关系,附 exit code 速查表。根分区 100%:一个没配 max-size 的 json.log,把 200G 磁盘“吃”成了 0 字节
凌晨磁盘告警,df 显示根分区 100%,罪魁是 /var/lib/docker。用 docker system df -v、du 逐层下钻,定位到 json-file 日志无限增长,讲清 max-size/max-file 配置、docker system prune 各选项的风险(--volumes 会删数据)与构建缓存清理。容器里 curl localhost 永远拒绝连接:Docker 网络的五个经典“不通”与 ufw 那个著名的坑
容器访问宿主机 MySQL 报 Connection refused,同一 compose 里 localhost 也不通。梳理 host.docker.internal 与 host-gateway、服务名 DNS、-p 与 EXPOSE、默认 bridge 无 DNS、ufw 被 Docker 绕过,附 docker network inspect 与 nsenter 排查命令和网络拓扑图。Java 搬进 Docker 就“水土不服”:容器 2G 内存,JVM 却以为自己有 64G
老 JDK 不识别 cgroup,容器限 2G 却按宿主机 64G 算堆,还按 32 核起线程,结果被 OOMKilled 或越跑越慢。讲清 UseContainerSupport、MaxRAMPercentage、堆外开销、cgroup v1/v2 文件,以及容器里 jstack/jmap 的正确姿势。挂载目录 Permission denied 及两个“难兄难弟”:时区差 8 小时、改了代码镜像纹丝不动
容器写挂载目录报 Permission denied,根因常是 UID 不一致,也可能是 SELinux 或只读挂载。顺带整理容器时区不对、构建缓存导致改了代码镜像没更新两个小坑,每条都给出复现现象与 id、ls -ln、docker exec 排查命令。
Nginx 与网络排查(3 篇)
502 还是 504?Nginx 给你的不是报错,是一张“尸检报告”
前端喊“接口 502”,后端说“我这儿好好的”。本文讲清 502(上游连不上/被掐断)与 504(上游超时)的区别,用 error.log 原文加自定义 access_log 三个 upstream 变量定位问题,并解释 keepalive、重启瞬间 502 与 proxy_next_upstream 的坑。早上全站“您的连接不是私密连接”:一张证书过期,让我提前体验了“社死”
某天早上全站弹“连接不是私密连接”,根因是 HTTPS 证书过期。用 openssl s_client 和 curl -v 看证书有效期与证书链,梳理 certbot/acme.sh 自动续期失败的常见原因,并给出提前 30 天告警的检查脚本。上传 5MB 就 413,WebSocket 每 60 秒准时“下班”:两个 Nginx 默认值的经典坑
一次上线连踩两个 Nginx 默认值:client_max_body_size 默认 1m 导致上传 413,Spring Boot multipart 与多层代理要逐层放开;WebSocket 每 60 秒断线,缺 Upgrade 头且 proxy_read_timeout 默认 60s。附 curl 复现命令与心跳方案。
微服务与中间件排查(5 篇)
一个慢接口引发的雪崩:Dubbo 超时 + 默认重试,把流量放大了 3 倍
下游一个慢接口,叠加 Dubbo 超时与默认 retries=2(最多调 3 次),流量被放大、provider 200 线程被占满并报 Thread pool is EXHAUSTED,故障从一个服务扩散到整条链路。附排查命令、超时分层、集群容错与限流降级的修法。配置改了线上不生效,服务下线了流量还在来:Nacos 配置与注册中心的两类“灵异事件”
两类高频“灵异事件”:Nacos 配置改了不生效(dataId/group/namespace 对不上、缺 @RefreshScope、@Value 与 @ConfigurationProperties 的差异、本地缓存),以及服务下线后仍有流量(心跳摘除延迟、消费者缓存、优雅停机顺序)。附 curl 查询配置与实例的排查清单。ES 写入全线 403:磁盘刚到 95%,整个集群就“只读”了——水位线三兄弟与 read_only_allow_delete
日志写入突然全部失败,报 index read-only / allow delete (api),集群还变了 yellow。顺着 _cluster/health、_cat/allocation、allocation/explain 一路查到磁盘水位线,讲清 85/90/95 三道线、解除只读的正确姿势,以及分片过多这个隐形推手。XXL-JOB 的三种“灵异现象”:重复执行、莫名不触发、执行器离线——一次讲透调度链路
同一个定时任务有时跑两遍、有时一遍都没跑、有时执行器在后台显示离线。沿着调度中心到执行器的链路,查注册地址、accessToken、路由与阻塞策略、misfire、执行超时,最后用幂等设计兜底。“用户说下单慢”:从一句废话到根因的定位漏斗——traceId、ELK、链路追踪与排查方法论总纲
客服转来一句“下单好慢”,怎么在半小时内定位到具体机构、具体接口、具体那一行调用?本文用一个完整时间线讲 traceId 贯穿(MDC、网关、Dubbo、MQ、线程池的坑)、Kibana KQL 检索、SkyWalking 看 span 耗时,并总结排查先问的 5 个问题和“定位漏斗”。
怎么读这个合集
值班前:先读「用户说下单慢」那篇的方法论,再扫一遍症状速查表。
出事时:按分层地图定位到层,再进具体文章抄命令。
事后:把自己的复盘也写成这个格式——写不清楚,就说明还没真懂。
一起聊聊