香港服务器上的网站出现502错误,如何结合Nginx访问日志与错误日志排查?
遇到 502 时,先确认错误由哪一层返回,再用同一请求的访问日志和错误日志定位故障发生在 Nginx、上游应用,还是两者之间的连接。访问日志适合回答“哪个请求、返回了什么状态、耗时多久”;错误日志通常能进一步说明连接被拒绝、响应超时或上游返回异常。香港服务器的机房位置本身不能解释 502,但若网站经过 CDN 或其他入口,用户看到的错误未必来自源站 Nginx。
排查时应把同一域名、请求路径、时间点和请求标识串起来看。若当前访问日志没有记录上游地址、上游状态和耗时,仍可先从错误日志及现有访问日志判断;这类字段不能从旧日志中补回,只能在确认需要后调整日志格式,为后续故障保留证据。
A5idc数据提供中国香港物理服务器租用,覆盖入门建站、Xeon Gold与AMD EPYC等配置,并配备SSD或NVMe存储及CN2、国际带宽等线路方案,可为Nginx反向代理后的企业网站、业务后台、数据库和接口服务提供计算、存储与网络资源基础,适配香港源站与CDN协同的部署场景。
先确认 502 是哪一层返回的
浏览器显示 502,只能说明请求链路中某一层认为上游响应不可用,不能直接判定是 Nginx 配置错误。常见链路是“访客—CDN或负载均衡—源站 Nginx—应用服务”,每一层都可能生成错误页。错误页样式、响应头或页面上的服务标识可提供线索,但单独看它们不能作为定论。

先记录一次可复现请求的以下信息:发生时间及所在时区、域名、路径、是否经过 CDN、客户端网络、返回状态码,以及是否所有页面都失败。尽量使用只读的健康检查地址或普通 GET 请求,避免用会提交数据的页面反复测试。若错误仅在香港以外的某些网络出现,或仅经 CDN 访问时出现,应把源站日志与入口层日志分开核对;不要仅凭地域差异就判断为源站带宽或机房故障。
在服务器上,先确认 Nginx 服务状态和时间设置。以下命令适用于使用 systemd 的 Linux;实际服务名可能因安装方式不同而变化:
sudo systemctl status nginx --no-pager
date
timedatectl
服务处于 active (running) 只说明进程在运行,不代表请求一定能成功转发。时间命令用于检查服务器时区和系统时钟;如果日志在不同主机或 CDN 控制台中对照,还要确认各系统记录时间的时区。不要为匹配日志而随意调整服务器时钟,时间跳变可能影响其他业务和日志顺序。
找到访问日志和错误日志
Nginx 日志路径由配置决定,常见位置包括 /var/log/nginx/access.log 和 /var/log/nginx/error.log,但不能假设所有系统都使用这两个文件。可先查看正在生效的配置:
sudo nginx -T 2>&1 | grep -nE '^[[:space:]]*(access_log|error_log|log_format|proxy_pass|fastcgi_pass|uwsgi_pass|grpc_pass)'
nginx -T 会展开读取到的配置文件,输出中可能包含内部路径、地址或其他敏感配置。只在受控终端查看,不要未经脱敏就把完整输出发到公开渠道。若命令没有找到日志指令,可能是配置写法跨行、使用了变量或日志由容器平台管理;此时应检查 Nginx 主配置及站点配置,或确认实际运行的容器和日志采集方式。
拿到实际路径后,先检查故障时间附近的记录。下面的时间只是示例,请替换为现场时间;grep 的匹配格式也要按日志中的时间格式调整:
sudo tail -n 200 /var/log/nginx/error.log
sudo grep -F '12/May/2025:14:30' /var/log/nginx/access.log
sudo grep -F '2025/05/12 14:30' /var/log/nginx/error.log
如果日志已经轮转或压缩,当前文件中可能没有目标时间段。先查看同目录下的轮转文件,再按实际文件名查询;压缩文件可使用 zgrep:
sudo ls -lh /var/log/nginx/
sudo zgrep -F '12/May/2025:14:30' /var/log/nginx/access.log.*.gz
查不到记录不等于请求没有到达服务器。可能原因包括:查错了虚拟主机或日志路径、请求被 CDN 拦截、日志尚未写入、日志已轮转,或访问日志在对应配置段被关闭。还要留意权限问题;不要为了读取日志而把日志文件改成所有用户可读。
访问日志看什么
先检查访问日志格式。标准格式常包含客户端地址、时间、请求行、状态码、响应字节数、来源页和用户代理,但不一定记录上游信息。请求行中的查询参数可能包含令牌、邮箱或其他敏感内容,引用日志时应先脱敏。
如果现有格式已经记录上游字段,可重点关注以下内容:
| 字段 | 用途 | 需要注意的情况 |
|---|---|---|
$status | Nginx 对客户端返回的状态码 | 502 说明该层返回了 502,不能单独说明上游故障原因 |
$request_time | Nginx 处理整个请求的耗时,单位为秒 | 较大时应结合上游耗时判断等待发生在哪一段 |
$upstream_addr | 实际尝试连接的上游地址 | 为空、- 或出现多个地址时,要结合路由、重试和具体请求分析 |
$upstream_status | 上游响应状态 | 与 $status 不同;不同值可能表示多次尝试 |
$upstream_connect_time | 建立上游连接所用时间 | 连接失败时可能没有有效耗时,不能仅凭短时间判定连接正常 |
$upstream_header_time | 收到上游响应头所用时间 | 较长可能与应用处理慢、排队或网络等待有关 |
$upstream_response_time | 从上游读取响应所用时间 | 可与 $request_time 对照,判断耗时主要集中在哪段 |
例如,以下是模拟日志,不代表任何实际服务器的记录:
12/May/2025:14:30:12 +0800 status=502 request_time=0.004 upstream_addr="127.0.0.1:8000" upstream_status="-" upstream_connect_time="-" upstream_header_time="-" upstream_response_time="-"
这条记录表示请求很快得到 502,但上游状态和耗时没有可用值。它支持“上游未能正常完成请求”这一判断,却不能单独区分端口无监听、连接被拒绝、配置目标不对,或日志变量未按预期记录。下一步要找同一时间附近的错误日志,并核对上游地址是否与当前生效配置一致。
另一条模拟记录可能是:
12/May/2025:14:32:08 +0800 status=502 request_time=2.103 upstream_addr="127.0.0.1:8000" upstream_status="502" upstream_connect_time="0.001" upstream_header_time="2.101" upstream_response_time="2.101"
这里连接建立很快,但上游最终返回了 502,响应头耗时接近总耗时。排查重点应转向上游应用自身的错误、应用调用的依赖服务,或上游 Nginx 等中间层,而不应首先认定为本机端口不可达。若同一变量中出现多个上游地址或状态,通常要结合 Nginx 的重试配置和错误日志逐次分析,不能只看最后一个值。
如果当前日志没有这些字段,可先利用已有字段完成初筛。访问日志不会自动包含未配置的变量,也不能从旧记录中恢复当时的上游地址和耗时。确认这会妨碍后续排障后,再考虑为后续请求增加专用日志格式,而不是覆盖原日志格式。
用时间线关联两类日志
访问日志通常在请求处理完成后写入,错误日志则可能在连接或读取上游的过程中记录。排查时先选定一条 502 访问记录,再向前后扩展一个短时间窗口,查找同一请求的错误信息。常见关联依据包括时间、域名、路径、上游地址和请求标识。若没有唯一请求标识,应结合多项信息判断,不能只凭“时间差不多”就断定两条记录属于同一次请求。

Nginx 的访问日志可能采用本地时间,常见格式带有时区偏移;错误日志也需要核对其时间格式。CDN 控制台、监控平台和应用日志则可能使用 UTC 或其他时区。对齐之前,先把各时间换算到同一时区,并考虑不同主机时钟不同步造成的小幅偏差。毫秒级定位时,可参考访问日志中的 $msec,前提是当前格式已记录该变量。
下面的错误日志行同样是模拟示例:
2025/05/12 14:30:12 [error] 1842#1842: *731 connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.15, server: example.com, request: "GET /health HTTP/1.1", upstream: "http://127.0.0.1:8000/health", host: "example.com"
它说明 Nginx 尝试连接 127.0.0.1:8000 时,连接被拒绝。应核对该端口是否有服务监听、Nginx 的上游目标是否正确,以及应用是否因崩溃或启动失败而退出。日志中的客户端地址在使用 CDN 时可能是 CDN 节点地址;除非已正确配置并限制可信代理来源,不要把请求头中的任意转发地址直接当作真实访客地址。
按错误特征分支定位
关联好时间线后,根据错误日志和访问日志中的上游字段选择下一步。典型判断如下:

| 日志特征 | 常见含义 | 下一步核查 |
|---|---|---|
connect() failed (111: Connection refused) | 目标地址可达,但端口没有接受连接,或服务主动拒绝 | 核对监听端口、应用进程、容器端口映射及上游配置 |
connect() failed (113: No route to host) 或连接超时 | 网络路由、防火墙或目标可达性存在问题 | 核对 Nginx 到上游的网络路径、主机防火墙和安全策略 |
upstream timed out | 在连接、读取响应头或读取响应期间等待超时 | 看日志中的阶段,并对照应用耗时、依赖服务和超时设置 |
upstream prematurely closed connection | 上游在响应完整结束前关闭连接 | 检查应用异常、进程退出、工作进程限制及上游日志 |
no live upstreams | 当前没有可用的上游节点 | 检查上游组成员、健康状态、解析结果及节点配置 |
upstream sent invalid header | 上游返回的响应头不符合 Nginx 预期 | 检查上游协议、应用输出及中间层响应格式 |
| 访问日志显示上游返回 502 | 上游某一层已经给出 502 | 继续沿上游链路查看对应服务日志,而非只查最外层 Nginx |
超时并不总是 502:读取上游超时常见结果是 504,但最终状态取决于具体阶段、错误类型、重试情况和链路中其他组件。应以现场访问日志中的 $status 及错误日志原文为准,不要把某个状态码机械地对应到单一原因。
如果是连接被拒绝,先只读检查监听情况:
sudo ss -lntp
将结果与 proxy_pass、fastcgi_pass 等实际上游配置比对。若上游是本机 TCP 端口,确认配置中的地址和端口与应用监听一致;若应用位于容器中,宿主机地址、容器地址和端口映射可能不同,不能把容器内部端口直接当作宿主机监听地址。若上游使用 Unix socket,还需确认 socket 路径存在、服务进程有权限访问;不要在未确认运行账户和目录权限前,直接递归修改权限。
对 HTTP 上游,可用安全的健康检查 GET 请求测试从服务器到上游的连通性。将地址和路径替换为实际配置;若健康检查接口不存在,应使用确认过的只读地址,不要对写入型业务接口执行探测:
curl -sS -D- -o /dev/null --max-time 5 \
-H 'Host: example.com' \
http://127.0.0.1:8000/health
若连接失败,而 ss 中也没有对应监听,问题更可能在应用服务状态或目标端口。若连接成功但返回 500 或 502,应查看应用日志及其依赖;若直连正常、经 Nginx 失败,则继续比较 Nginx 实际转发的协议、主机头、路径和上游地址。需要 HTTPS 的上游应按真实的 TLS、主机名和证书配置进行测试,不能用普通 HTTP 请求代替验证。
若日志指向读取超时,不应马上把 proxy_read_timeout 调大。先比较 $request_time 与 $upstream_response_time,再检查应用日志、数据库或其他依赖的响应时间及并发情况。增加超时可能只是让请求等待更久,还会占用连接和工作资源;只有确认业务确实允许较长处理时间,并评估并发影响后,才调整超时参数。
香港服务器经过 CDN 时的分层核对
若域名经 CDN 或负载均衡访问,应同时确认入口层是否将请求转发到了这台香港服务器。先选取同一条访问记录的时间、路径和请求标识,查询入口层对应日志;如果入口层记录为回源失败而源站没有对应请求,问题可能发生在入口到源站这一段。如果源站访问日志记录了该请求并返回 502,则应继续依据源站错误日志定位上游应用或源站 Nginx 配置。
在获准绕过入口层、且确认直连不会改变业务行为时,可用 curl --resolve 在保留域名和 TLS 主机名的条件下测试指定源站地址。以下地址为文档示例,执行前必须替换为已确认的源站 IP 和只读路径:
curl -sS -D- -o /dev/null --max-time 10 \
--resolve example.com:443:203.0.113.10 \
https://example.com/health
如果直连源站正常、经 CDN 访问失败,应检查入口层的回源地址、协议、端口、证书和访问策略;如果两种方式都失败,则转回源站日志及应用状态。不要仅凭响应头中的 Server 字段判定故障来源,也不要为测试而公开源站地址或放宽源站访问控制。
日志字段不足时的后续改进
只有在现有访问日志不足以关联请求时,才考虑增加诊断字段。下面的示例用于 Nginx 的 http 配置上下文;$request_id 取决于 Nginx 版本,先用 nginx -v 核验。格式使用 $uri 而不是完整 $request_uri,以降低记录查询参数敏感信息的风险:
log_format upstream_diag '$msec $request_id $remote_addr $host '
'"$request_method $uri $server_protocol" '
'status=$status request_time=$request_time '
'upstream_addr="$upstream_addr" '
'upstream_status="$upstream_status" '
'upstream_connect_time="$upstream_connect_time" '
'upstream_header_time="$upstream_header_time" '
'upstream_response_time="$upstream_response_time"';
access_log /var/log/nginx/access_upstream_diag.log upstream_diag;
不要直接替换现有的 log_format 或 access_log 配置;可先备份对应配置文件,并确认新增日志不会导致磁盘空间或敏感信息暴露问题。修改后先检查语法,再平滑重载:
sudo nginx -t
sudo systemctl reload nginx
只有 nginx -t 返回配置测试成功后才执行重载。重载后应发起一条只读测试请求,并确认新日志文件生成且字段有值。若语法检查失败,不要重载;按报错定位并恢复备份。若上线后出现预期外的日志量、磁盘增长或字段缺失,移除新增配置、再次执行 nginx -t,通过后重载恢复原配置。日志中出现多个上游地址或状态时,应保留原始顺序,结合错误日志分析重试过程,不要只截取一个值。
修复后复测与持续观察
修复动作应对应已确认的原因:端口错误就修正并核实上游目标;应用未运行就先通过服务管理和应用日志确认启动条件;上游返回异常就修复应用或其依赖;入口层回源问题则在对应入口配置中调整。不要把重启、改权限、放宽防火墙或提高超时当成通用处理方式。涉及配置变更时先备份,限定影响范围,完成语法或连通性检查,并保留可恢复的原配置。
复测时至少比较三项:客户端请求是否恢复、访问日志中的状态码是否符合预期、错误日志是否仍出现相同上游错误。若问题间歇发生,应在一段覆盖业务峰值的观察窗口内检查 502 比例、上游连接失败数、上游响应耗时和应用资源情况;单次请求成功不能证明故障已经消失。若 502 仍在但错误特征发生变化,应按新的日志重新建立时间线,而不是沿用旧故障结论。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9462.html



