访问网站时出现“504 Gateway Timeout”,说明某个网关或代理等待上游响应超时。使用阿里云CDN时,浏览器里的504不一定是CDN节点故障:请求可能卡在CDN回源、源站负载均衡、Web服务器或应用程序。排查时先找出错误出现在哪一段,再沿请求链路逐层检查。只清缓存或直接调大超时时间,往往解决不了问题,还可能掩盖真正原因。
先判断:504发生在哪个环节
一次请求通常经过“浏览器—阿里云CDN节点—源站”。源站前如果还有SLB、Nginx、WAF、网关或应用代理,任何一层都可能先超时。不同组件留下的日志不同,处理方向也不一样。
- 记录故障范围:记下出错URL、发生时间、访问地区、网络和请求方式,并确认是所有页面出错,还是只有动态接口、上传请求或某类静态文件受影响。故障越具体,后续越容易和日志时间对应。
- 查看响应信息:在浏览器开发者工具中记录状态码、响应头和响应内容,再查CDN控制台的访问日志、回源日志及错误信息。响应头可以提供线索,但单凭一个响应头不能确定是哪一方的问题。
- 对比访问路径:条件允许时,用同一URL、同一请求方式分别测试CDN域名和源站。直连源站成功、经CDN失败时,重点检查回源链路;两种方式都失败,则先看源站和应用。
阿里云CDN 504的5步排查方法
第1步:确认是全站问题还是局部问题
分别测试首页、静态资源、动态页面和接口。如果只有某个接口超时,常见排查方向包括接口处理变慢、数据库查询拥堵或依赖服务异常;如果多个域名或目录同时出错,则要检查源站容量、网络和共享代理。也可以从不同地区、不同运营商重复测试,判断故障是否只出现在某条网络路径上。
第2步:检查源站响应速度和资源状态
查看504发生时段的CPU、内存、磁盘、连接数、Web服务器工作进程和应用线程池。留意是否有流量突增、进程重启、连接池耗尽、数据库慢查询,或外部服务调用时间变长。可以用带超时限制的curl请求同一URL,并记录DNS解析、建立连接、首字节和总耗时,帮助判断时间花在了哪一段。
测试时注意控制请求频率,遵守源站访问策略,别为了排查给线上服务增加额外压力。如果单次测试正常,也不要立即排除源站问题:偶发超时可能只在高峰期或特定请求条件下出现,应把测试时间和故障日志对照起来看。
第3步:核对回源配置和网络连通性
检查CDN控制台中的源站地址、端口、协议和回源HOST,确认它们与源站实际服务一致。源站使用HTTPS时,还要核对证书、SNI和监听配置。若配置刚做过调整,留意是否有域名解析指向错误、端口未监听等情况。
源站启用了防火墙、安全组或访问控制时,确认CDN回源流量没有被误拦截。修改白名单前,按阿里云当前文档确认适用的回源地址范围;不要为了快速验证就把源站无保护地开放给所有来源。
第4步:沿代理链找出超时位置
源站前有负载均衡、WAF、Nginx或其他网关时,逐层查看访问日志和错误日志,重点比较请求时间、上游耗时和状态码。比如负载均衡已经转发请求,Nginx日志却显示上游响应超时,就要继续检查应用;如果请求没有进入源站,则回头核对CDN回源配置、网络访问控制和中间代理。
排查时尽量使用同一条请求的时间戳、URL或请求标识关联不同组件的日志。只看某一层的错误记录,容易把“在哪一层发现问题”误当成“问题由哪一层造成”。
第5步:变更后按原条件复测
修复源站问题或调整配置后,用相同URL和请求方式复测,并尽可能覆盖多个地区。之后继续观察CDN日志与源站指标,确认错误是否减少、响应时间是否恢复。每次只调整一个关键因素,并记下变更内容和时间,出现反效果时才方便回滚和判断原因。
清理缓存不是处理504的通用方法。缓存清理主要影响缓存内容,通常不能解决回源超时;如果问题只发生在动态请求上,清缓存大多帮不上忙。
案例:接口偶发504,问题出在数据库
某电商网站将商品图片和API域名都接入CDN。活动开始后,图片访问正常,商品详情接口却偶尔返回504。运维人员一开始怀疑CDN节点不稳定,清理缓存后故障仍然出现。随后,他们对比CDN请求和源站直连结果,发现直连时接口也会变慢。
查看源站应用日志后,团队确认请求已经进入应用,但数据库查询耗时增加,数据库连接池在高峰时段接近耗尽。之后,他们优化详情查询、增加必要的缓存,并调整数据库连接池和应用并发配置。变更完成后,用同一接口从多个网络重复测试,并结合CDN回源日志观察超时数量是否下降。
这个案例里,CDN能加速内容分发,却不能替代源站容量和应用性能治理。动态接口出现504时,先确认请求有没有抵达源站,再看应用处理和数据库查询耗时,比反复清缓存更有针对性。
常见误区与处理建议
- 看到504就判定CDN故障:先结合日志和源站直连测试划定故障范围,再按请求链路往下查。
- 直接放宽所有超时参数:超时时间变长,用户可能要等更久,服务器连接也会占用更长时间。只有确认业务确实需要较长处理时间后,才评估调整,并同时检查并发量和资源容量。
- 忽略特定请求的差异:如果只有特定参数、路径或请求体会触发问题,检查对应的应用逻辑、接口依赖和请求大小,不要直接改全站配置。
- 高峰期连续改配置:每次变更都记录内容、时间和验证结果。一次先改一个关键因素,方便判断效果;如果错误增加,应能及时回滚。
减少504再次发生
为核心接口监控源站响应时间、错误率、并发量和数据库连接数。耗时任务可以评估异步处理,适合缓存的内容则设置合理的缓存策略。大促或版本发布前,提前做容量评估和压测,避免流量上来后才发现连接池或应用线程不足。
同时保留CDN访问日志和回源日志,并明确CDN、网络、源站与应用的排查分工。问题持续存在、现有日志又无法定位时,整理故障时间、请求URL、响应信息、源站测试结果及相关日志,再联系阿里云技术支持协助分析。
排查阿里云CDN 504时,围绕三个问题推进:请求到达了哪里、在哪一层等待、超时前各组件记录了什么。先划定故障范围,再查回源连通性、源站负载和代理日志,通常比猜测故障组件或盲目改配置更有效。