浏览量 12
网页访问故障可沿 DNS、连接、TLS、反向代理和上游服务逐层定位。以下用临时 Nginx 容器复现健康检查返回 200、首页返回 502 的场景。
从出问题的客户端发一次请求
先记下访问的域名、路径、时间和报错,再尽量在出现问题的机器上复现。下面的域名是占位符,实际排查时换成目标域名。用 GET 请求原来出问题的路径,可以保留和浏览器访问更接近的条件。
getent ahosts example.com
curl -v --connect-timeout 3 --max-time 10 \
-o /dev/null https://example.com/
Could not resolve host 时先查名称解析和返回的地址。TCP 连接超时或被拒绝时,检查目标 IP、端口、云安全组和服务监听。连接建立后才出现证书错误,就看证书有效期、域名匹配和证书链。收到 HTTP 502 时,说明客户端已经拿到了某个网关的响应,再根据日志确定是哪一跳返回的。
在服务器侧,使用 ss -lntp 看本机监听地址,用 docker compose ps --all 对照容器状态和端口映射。Docker 也可能通过 NAT 转发,因此需用实际请求确认端口是否可达。监听在 127.0.0.1 的预览入口,应当从服务器本机或 SSH 隧道测试。
同一个 Nginx,为什么一个路径 200、另一个 502?
把下方配置存成 nginx-demo.conf。/healthz 由 Nginx 直接返回,首页则被代理到一个在实验容器内没有服务监听的端口。两次请求都从同一个容器发出,便于把变量缩小到是否经过上游。
error_log /dev/stderr;
pid /tmp/nginx-demo.pid;
events {}
http {
server {
listen 127.0.0.1:8080;
location = /healthz { return 200 "ok"; }
location / { proxy_pass http://127.0.0.1:65534; }
}
}
docker run --rm --network none \
--mount "type=bind,source=$PWD/nginx-demo.conf,target=/tmp/nginx-demo.conf,readonly" \
--entrypoint sh nginx:stable-alpine -c '
nginx -t -c /tmp/nginx-demo.conf &&
nginx -c /tmp/nginx-demo.conf || exit 1
wget -S -O /dev/null http://127.0.0.1:8080/healthz
wget -S -O /dev/null http://127.0.0.1:8080/
'
在隔离容器里验证时,/healthz 返回 200,首页返回 502。Nginx 错误日志同时记录了 Connection refused 和上游地址。这条日志才把这次 502 定位到上游端口。别的 502 也可能来自协议配错或上游提前断开,需要重新看对应请求的日志。
博客预览环境的排查顺序
# 在博客的 Compose 项目目录执行,保留预览站所用的 Host
curl -sS -i --max-time 5 -H 'Host: localhost:18080' \
http://127.0.0.1:8080/healthz
curl -sS -o /dev/null -w 'HTTP %{http_code}\n' --max-time 5 \
-H 'Host: localhost:18080' http://127.0.0.1:8080/
docker compose ps --all
docker compose logs --since 10m --tail 100 nginx wordpress
如果首页 502,先按复现时间找 Nginx 的 upstream 错误,再核对 WordPress 容器有没有退出、目标服务名和端口是否写对。Compose 里的 127.0.0.1 指当前容器自身,跨容器访问要从代理所在的网络去验证。修复后要重试原来失败的路径,再看同一时间段还有没有新错误。
