首页/AI/大模型部署与运维速查/服务超时:先定界再调参
本包目录(267 条)
部署形态与选型43 条推理环境与 GPU50 条推理参数与优化50 条显存与并发估算40 条服务化与网关34 条
运维监控与排障50 条

服务超时:先定界再调参

超时要先定界:客户端读超时、网关代理超时、引擎排队、生成本身耗时是四条不同路径;用状态码与引擎指标把责任层找出来,再调整对应参数。

504网关等上游超时:上游还在算或已卡住
499客户端先断开:多为其读超时更早到点
排队等待并发超容量:请求在队列里耗掉预算
生成超时长输出或慢解码:单请求超预算

定界证据

定界证据
tail -n 200 <nginx错误日志> | grep 'upstream timed out'
grep ' 499 ' <nginx访问日志> | tail -5
curl -s http://127.0.0.1:8000/metrics | grep -E 'num_requests_waiting|time_to_first_token'
  • 分层预算:客户端读超时 > 网关 proxy_read_timeout > 单请求处理时间上限
  • SSE 场景保持心跳并关闭中间层缓冲,避免空闲连接被掐断
  • 队列造成的等待在容量侧解决:改超时只是把失败方式换个样子

易错点

  • 直接放大所有超时:掩盖容量不足,客户端体验变成长时间无响应

数据来源与参考

  • nginx 官方文档:ngx_http_proxy_module(proxy_read_timeout,nginx.org)
  • vLLM 官方文档:Production Metrics(docs.vllm.ai)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌