Linux 与服务器运维 / 系统课时

接口超时从网络层继续排查

接口超时从网络层继续排查

接口超时时,先不要把问题直接归因于“应用慢”。本节用 ss 确认监听与连接状态,再用 curl 拆分连接建立、首字节等待和总耗时,把“连不上”和“连上但处理慢”分开定位。

学习目标

  • 用 ss 判断目标端口是否监听、连接是否已经建立
  • 用 curl 的阶段耗时区分 TCP 建连失败与应用处理缓慢
  • 按网络到应用的顺序收敛接口超时的故障范围

先区分超时发生在哪一段

一次 HTTP 请求至少要经历“客户端发起连接 → 服务端端口监听 → TCP 连接建立 → 应用接受并处理 → 返回首字节”。如果 TCP 都没有建立,继续查业务代码通常没有意义;如果连接已经是 ESTAB,但首字节迟迟不返回,排查重点才应转向应用线程、数据库或下游依赖。

接口超时的分层定位路径

先确认服务是否监听

在服务端执行以下命令,并把 <PORT> 替换为接口实际监听端口。查看进程信息通常需要足够权限。

bash
sudo ss -lntp | grep ':<PORT>'

预期输出(端口正在监听时):

text
LISTEN 0 4096 0.0.0.0:<PORT> 0.0.0.0:* users:(("<PROCESS>",pid=<PID>,fd=<FD>))

如果没有任何输出,先检查进程是否启动、监听端口是否配置正确,以及服务是否只监听了其他地址。若只看到 127.0.0.1:<PORT>,远程客户端无法直接访问该监听地址;若看到 0.0.0.0:<PORT> 或 [::]:<PORT>,则需要继续检查主机防火墙、路由和上游网络策略。

再看连接是否真正建立

在请求发生时观察与目标端口相关的 TCP 连接:

bash
sudo ss -tnp | grep ':<PORT>'

预期输出(已经建立连接时):

text
ESTAB 0 0 <LOCAL_IP>:<LOCAL_PORT> <REMOTE_IP>:<PORT> users:(("<PROCESS>",pid=<PID>,fd=<FD>))

实际 IP、端口、PID 和文件描述符会不同。持续出现 ESTAB 说明 TCP 握手已经完成,此时“连接建立失败”不再是主要假设;若客户端仍超时,应关注应用是否读取请求、等待锁、访问数据库或调用下游服务。

用 curl 拆分时间花在哪里

假设目标服务提供 /health,可在客户端执行:

bash
curl -sS -o /dev/null --connect-timeout 3 --max-time 8 -w 'http_code=%{http_code} connect=%{time_connect} starttransfer=%{time_starttransfer} total=%{time_total}\n' http://<HOST>:<PORT>/health

预期输出(请求成功时):

text
http_code=200 connect=<TIME> starttransfer=<TIME> total=<TIME>

这里的 <TIME> 是实际测量值。connect 明显偏大,说明时间主要花在 TCP 建连阶段;starttransfer - connect 明显偏大,表示连接已建立,但服务端直到返回首字节前花费了较长时间;total 明显大于 starttransfer,则还要考虑响应体传输速度。若接口不是 /health,应替换成真实可调用路径。

按证据决定下一步

当 ss 看不到监听时,优先处理进程、绑定地址和端口配置;监听存在但客户端建连慢或失败时,继续检查路由、防火墙和中间网络设备;连接已经建立且 time_starttransfer 明显偏大时,再进入应用层排查线程阻塞、系统调用等待、数据库慢查询或下游接口延迟。这样可以避免在错误的层次上反复猜测。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接口超时从网络层继续排查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通