香港云服务器作为负载均衡后端时,健康检查返回404该查哪些配置
监控面板显示香港云服务器已经加入负载均衡后端池,但健康检查持续返回 HTTP 404;与此同时,浏览器访问业务域名却能正常打开,这类问题通常不是香港地域本身导致的,而是健康检查请求与业务请求使用了不同的路径、端口、协议、Host 或请求方法。
排查时不要只访问负载均衡的公网域名。应先还原负载均衡实际发往后端的请求,再从负载均衡配置、后端监听端口、Web 服务虚拟主机、反向代理规则和应用路由逐层比对。HTTP 404通常说明请求已经到达某个 HTTP 服务,但该服务没有匹配到请求路径;如果后端完全不可达,更常见的是连接超时、连接拒绝或 TLS 握手失败。
A5idc数据面向网站、业务后台、数据库和接口服务,提供中国香港物理服务器资源,覆盖入门建站、Xeon Gold及AMD EPYC等配置,并配备SSD或NVMe存储,适合承载Nginx、应用服务及健康检查接口等多层业务组件。香港产品同时提供CN2与国际带宽选择,可结合访问来源与业务链路构建后端节点;对于需要多地址或更大带宽的场景,品牌还提供多IP及相应带宽方案,为负载均衡后的多台服务器部署提供硬件与网络资源基础。
先确认404来自哪里
区分负载均衡返回和后端返回
先在负载均衡控制台记录以下配置,不要凭业务域名或浏览器地址栏推断:
- 健康检查协议:HTTP 还是 HTTPS。
- 健康检查端口:是否与后端业务监听端口一致。
- 检查路径:例如
/healthz、/status或/api/health。 - 请求方法:GET、HEAD,或平台固定使用的方法。
- Host 请求头:是否设置为业务域名。
- 健康状态码范围:通常是 2xx,部分平台允许自定义。
- 超时时间、检查间隔以及连续成功、失败次数。
- 后端池中登记的是香港云服务器的私网地址、公网地址,还是某个容器或实例端口。
404响应本身也有判断价值。可以重点观察响应头和响应体:
HTTP/1.1 404 Not Found
Server: nginx
Content-Type: text/html
这类结果可能由 Nginx 生成,也可能只是后端应用伪装了 Server 头,不能仅凭一个响应头下结论。若响应体带有应用框架特征、业务错误码或自定义 JSON,通常更接近应用路由返回;若后端访问日志中完全没有对应请求,则需要考虑负载均衡在到达后端前生成了响应,或者请求实际落到了其他目标。
用GET请求还原健康检查
不要先使用浏览器测试,也不要只使用 curl -I。curl -I发送的是 HEAD 请求,可能与负载均衡的 GET 检查产生不同结果。
在能够访问后端私网地址的跳板机或同一网络中的诊断主机上,执行类似命令:
BACKEND_IP=10.0.2.15
BACKEND_PORT=8080
curl --noproxy '*' -sv \
--connect-timeout 3 \
--max-time 5 \
"http://${BACKEND_IP}:${BACKEND_PORT}/healthz"
这里的 10.0.2.15、8080 和 /healthz仅为示例,必须替换成负载均衡后端池中实际登记的地址、端口和路径。
重点观察以下结果:
- 返回
200:说明不带特定 Host 时路径可用,下一步重点检查负载均衡是否携带了不同的 Host、协议或方法。 - 返回
404:说明该端口上的服务没有匹配/healthz,继续检查 Web 服务和应用路由。 - 返回
301或302:说明存在跳转。不要使用-L隐藏跳转过程,先确认负载均衡是否接受 3xx。 - 返回
401、403或405:说明权限控制或请求方法可能不符合检查要求。 - 连接超时或拒绝:此时不应继续围绕 404排查,应转向安全组、监听地址、路由和端口映射。
如果业务依赖指定域名,再补充带 Host 头的请求:
curl --noproxy '*' -sv \
--connect-timeout 3 \
--max-time 5 \
-H 'Host: app.example.com' \
"http://${BACKEND_IP}:${BACKEND_PORT}/healthz"
如果不带 Host 返回 404,而带上 app.example.com 后返回 200,基本可以确认是虚拟主机匹配问题,而不是健康路径本身不存在。
对比HEAD和GET
负载均衡平台可能允许选择请求方法,也可能使用固定的 HEAD 检查。需要分别验证:
curl --noproxy '*' -sS -D - -o /dev/null \
-X HEAD \
-H 'Host: app.example.com' \
"http://${BACKEND_IP}:${BACKEND_PORT}/healthz"
curl --noproxy '*' -sS -D - -o /dev/null \
-X GET \
-H 'Host: app.example.com' \
"http://${BACKEND_IP}:${BACKEND_PORT}/healthz"
典型判断如下:
- GET 和 HEAD 都是 200:请求方法大概率不是问题。
- GET 是 200、HEAD 是 404 或 405:应用只实现了 GET 路由,或者中间件拒绝 HEAD。应将负载均衡检查方法改为 GET,或者让应用和Web服务正确处理 HEAD。
- GET 和 HEAD 都是 404:继续检查路径、Host 和路由。
- 本地 GET 正常,但负载均衡仍显示 404:重点检查负载均衡实际发送的 Host、端口、协议和目标地址。
查看后端是否真正收到检查请求
在 Nginx环境中,可以先读取访问日志,不要立即修改配置:
sudo tail -n 100 /var/log/nginx/access.log
也可以按路径筛选近期请求:
sudo grep -E '"(GET|HEAD) /healthz([/? ]|$)' \
/var/log/nginx/access.log | tail -n 30
不同发行版和日志配置的路径可能不同。若Nginx由 systemd 管理,还可以查看服务日志:
sudo journalctl -u nginx --since "15 minutes ago" --no-pager
判断方式如下:
- 能看到健康检查请求,且状态码是 404:请求已经到达Nginx,重点查
server_name、location和上游应用。 - 能看到请求,但访问的是另一个路径:负载均衡配置中的路径与预期不一致,或者中间存在路径改写。
- 完全看不到请求:可能检查端口不是Nginx监听端口、请求落到其他服务、负载均衡未真正发送请求,或响应在到达该Nginx前就已生成。
- 只在某一台香港云服务器上出现:优先怀疑后端配置漂移、镜像版本不同或单台实例的虚拟主机配置缺失。
按链路由外到内检查
1. 检查健康检查路径和状态码设置
健康检查路径必须是后端真实存在的 HTTP 路径,而不是业务首页、带完整域名的 URL,或只在浏览器前端路由中存在的路径。
例如,以下是一组通用的示例配置:
协议:HTTP
端口:8080
路径:/healthz
方法:GET
Host:app.example.com
成功状态码:200
超时时间:3 秒
检查间隔:10 秒
这些参数不是所有云平台的固定字段,实际名称以所使用的负载均衡产品为准。排查时尤其注意以下细节:
| 检查项 | 常见配置错误 | 典型表现 |
|---|---|---|
| 路径 | 配置为 /healthz,应用实际只有 /api/health | 后端日志出现 404 |
| 尾部斜杠 | /healthz 与 /healthz/ 被应用视为不同路由 | 一个路径200,另一个路径404 |
| 大小写 | /Healthz 与 /healthz 不一致 | Linux环境下常见404 |
| 路径前缀 | 应用部署在 /service 下,但检查使用根路径 | 负载均衡访问到不存在的路由 |
| Host | 未设置业务域名,命中默认虚拟主机 | Nginx或网关返回404 |
| 方法 | 检查使用HEAD,应用只支持GET | 返回405或自定义404 |
| 成功状态码 | 后端返回200,但平台只接受特定状态码 | 控制台显示不健康,但不一定是404 |
| 协议 | 检查使用HTTPS,后端实际只提供HTTP | 常见为握手失败,也可能进入错误虚拟主机 |
健康检查路径不一定要与用户业务路径相同。更适合使用一个短小、稳定、无需登录的专用接口,例如 /healthz。该接口只返回状态码和简短文本,不应返回数据库连接串、版本详细信息、环境变量或内部地址。
2. 确认后端端口和协议没有指向另一个服务
同一台香港云服务器上可能同时运行Nginx、应用进程、容器网关和管理面板。负载均衡检查的是登记的目标端口,不是“这台服务器上任意可访问的端口”。
先查看监听情况:
sudo ss -lntp
如果负载均衡目标端口是 8080,可以进一步筛选:
sudo ss -lntp | grep ':8080'
需要确认:
- 端口是否处于
LISTEN状态。 - 监听地址是
0.0.0.0:8080、私网地址,还是仅有127.0.0.1:8080。 - 监听端口对应的进程是否真的是预期的Web服务。
- HTTPS端口是否与HTTP端口混淆。
- 容器端口、宿主机端口和负载均衡目标端口是否一致。
如果服务只监听 127.0.0.1,本机访问可能正常,但负载均衡通过私网地址访问时无法进入该服务。此时通常表现为超时或拒绝连接;若该端口恰好由另一个Web服务监听,则可能出现“能收到响应但返回404”的情况。
对于HTTPS后端,可使用域名解析覆盖来保留正确的SNI:
BACKEND_IP=10.0.2.15
BACKEND_PORT=8443
curl --noproxy '*' -skv \
--connect-timeout 3 \
--max-time 5 \
--resolve app.example.com:${BACKEND_PORT}:${BACKEND_IP} \
"https://app.example.com:${BACKEND_PORT}/healthz"
这里的 -k仅用于诊断证书信任问题,不代表生产环境应该关闭证书校验。--resolve让请求连接到指定后端地址,同时仍使用 app.example.com作为访问域名,有助于验证TLS SNI和虚拟主机选择。
如果HTTP访问返回200,而HTTPS访问返回404,应检查:
- HTTPS端口是否配置了另一组Nginx
server块。 - 负载均衡是否在前端终止TLS后使用HTTP访问后端。
- 后端HTTPS是否需要特定SNI。
- HTTPS虚拟主机中的路径配置是否与HTTP虚拟主机一致。
3. 检查Nginx虚拟主机和Host头
Nginx可能配置了一个默认站点,用于对未知域名返回404。例如:
server {
listen 8080 default_server;
server_name _;
return 404;
}
server {
listen 8080;
server_name app.example.com;
location / {
proxy_pass http://app_backend;
}
}
当负载均衡不发送 Host: app.example.com时,请求会进入第一个默认站点。此时即使应用路由完全正确,健康检查仍会得到404。

可以使用当前Nginx配置检查端口和域名匹配关系:
sudo nginx -T 2>/dev/null | grep -nE 'listen|server_name|healthz|location'
nginx -T可能输出完整配置,配置中如果含有认证信息,不要直接复制到公开工单或聊天记录中。
修复方式通常有两种:
- 在负载均衡健康检查中设置正确的Host头。
- 在实际命中的Nginx虚拟主机中提供专用健康路径。
以下配置是示例,表示在 8080端口、app.example.com虚拟主机下提供固定的200响应:
server {
listen 8080;
server_name app.example.com;
location = /healthz {
default_type text/plain;
add_header Cache-Control "no-store";
return 200 "ok\n";
}
location / {
proxy_pass http://app_backend;
}
}
location = /healthz是精确匹配。使用该配置时,/healthz和/healthz/不是同一个路径。如果负载均衡配置的是后者,应统一两边的写法,或明确增加对应规则。
如果无法在健康检查中设置Host头,可以考虑在默认虚拟主机中增加一个不依赖域名的健康路径,但应先确认该路径不会暴露敏感信息,也不会绕过正常业务访问控制。不要为了让检查变绿而直接删除默认站点的安全规则。
4. 检查反向代理的路径改写
路径改写是404问题中容易被忽略的一层。例如,负载均衡请求的是:
/service/healthz
Nginx可能将它转发成:
/healthz
也可能原样转发成:
/service/healthz
示例配置如下:
location /service/ {
proxy_pass http://app_backend/;
}
在这种写法中,匹配到的 /service/前缀会被替换为 proxy_pass中指定的 /,后端通常收到 /healthz。
如果写成:
location /service/ {
proxy_pass http://app_backend;
}
则通常会保留原始请求路径,后端更可能收到 /service/healthz。具体行为还会受URI规范化和其他location规则影响,因此不要只看配置片段,要结合Nginx访问日志和应用日志确认后端实际收到的路径。

应分别检查:
- 负载均衡配置的原始检查路径。
- Nginx访问日志中的路径。
- 应用日志中的路由路径。
- API网关或容器入口是否再次添加或删除前缀。
/healthz与/service/healthz是否分别存在。
如果只有业务接口部署在某个前缀下,不要直接把根路径健康检查转发到业务应用后再猜测。可以在Nginx层提供固定的健康响应,也可以在应用中明确注册与部署前缀一致的健康路由。
5. 检查应用路由、认证和中间件
如果Nginx访问日志显示已经收到 /healthz,但应用日志返回404,问题通常在应用层:
- 路由没有注册。
- 应用实际上下文路径不同。
- 健康模块未启用。
- 健康接口只在某个环境配置中开启。
- 路由注册顺序被通用404处理器提前截获。
- 认证、租户或权限中间件把未识别请求统一伪装成404。
- 多个应用实例版本不同。
可以在本机或后端私网地址分别请求应用入口和Nginx入口,确认是哪一层产生404:
curl --noproxy '*' -sv \
-H 'Host: app.example.com' \
"http://127.0.0.1:8080/healthz"
curl --noproxy '*' -sv \
-H 'Host: app.example.com' \
"http://${BACKEND_IP}:8080/healthz"
如果本机返回200、通过私网地址返回404,优先检查Host、监听地址、虚拟主机和网络入口;如果两者都返回404,则应查看应用路由和部署配置。
健康接口通常不应依赖登录Cookie、用户Token或浏览器特有请求头。若安全策略要求限制访问范围,应在网络层或明确的访问控制规则中限制负载均衡检查来源,而不是让应用对未认证请求随机返回404。负载均衡检查源地址以所使用云平台公布或控制台显示的信息为准,不要凭经验放行大段公网地址。
6. 检查多台后端是否配置漂移
如果后端池中有多台香港云服务器,而健康状态间歇性变化,可能是不同实例上的以下内容不一致:
- Nginx配置文件不同。
- 应用版本不同。
- 容器镜像或环境变量不同。
- 健康路由只在部分节点部署。
- 某一台实例的监听端口指向了旧服务。
- 默认虚拟主机顺序不同。
应逐台使用相同的私网地址、端口、Host和路径测试,并记录结果:
| 后端 | GET结果 | HEAD结果 | 带Host后结果 | Nginx是否有日志 | 初步判断 |
|---|---|---|---|---|---|
| 10.0.2.15 | 200 | 200 | 200 | 有 | 配置基本一致 |
| 10.0.2.16 | 404 | 404 | 200 | 有 | 未带Host时命中默认站点 |
| 10.0.2.17 | 404 | 405 | 404 | 有 | 路由或方法处理不一致 |
上表是判断示例,不代表任何实际环境。只有当每台后端对同一组请求返回一致结果后,才适合继续调整负载均衡参数。
根据结果选择修复方向
后端精确请求返回200,但负载均衡仍返回404
优先检查负载均衡侧:
- 健康检查路径是否完全一致,包括大小写和尾部斜杠。
- 检查端口是否为实际监听端口。
- 健康检查是否使用了不同的协议。
- 是否配置了Host头。
- 负载均衡是否使用HEAD,而测试使用GET。
- 后端池登记的IP是否是实际测试的那台服务器。
- 是否存在旧的健康检查配置、旧监听器或旧后端池。
不要通过把404加入“健康状态码”来掩盖路径错误。除非业务明确设计为返回404且平台也明确支持这种语义,否则健康接口应返回稳定的2xx状态码。
后端精确请求也返回404,且Nginx日志有记录
此时负载均衡网络链路基本可用,重点按以下顺序检查:
server_name是否匹配请求Host。location是否匹配检查路径。- 反向代理是否改写了路径。
- 应用是否注册了该路由。
- 是否存在认证、租户或网关中间件。
- 是否只有部分后端版本缺少该接口。
修改前先保存当前配置。以常见Nginx配置路径为例,实际路径应先通过 nginx -T确认:
sudo cp -a /etc/nginx/sites-available/example \
/etc/nginx/sites-available/example.bak.$(date +%F-%H%M%S)
然后编辑配置,完成后先检查语法:
sudo nginx -t
只有看到语法检查成功,才执行平滑重载:
sudo systemctl reload nginx
如果 nginx -t失败,不要重载。若重载后结果异常,可恢复刚才的备份文件,再次执行 nginx -t,确认成功后再重载。重载通常不会中断已有连接,但配置变更仍应安排在可观察的维护窗口内。
本机返回200,私网地址返回404
这类结果常见于:
- 本机请求使用了
127.0.0.1,进入了不同的监听服务。 - 私网请求使用IP作为Host,命中了默认虚拟主机。
- Nginx按来源地址或请求头选择了不同规则。
- 容器只映射了本地端口,外部入口由另一个服务接管。
- 云服务器上的安全策略或网关对不同来源返回了统一的404页面。
应继续用带Host头的私网请求验证,不要只修改应用代码。如果带Host后恢复200,应优先修正负载均衡Host配置或Nginx虚拟主机匹配。
负载均衡没有后端日志,控制台却显示404
此时不要继续改应用路由。检查:
- 控制台显示的404是否是负载均衡自身生成。
- 后端池目标IP和端口是否写错。
- 检查协议是否与监听端口不匹配。
- 负载均衡是否仍引用旧的后端池。
- 是否有中间网关、API入口或WAF在后端之前返回404。
- 香港云服务器的私网网络、路由表和安全组是否允许负载均衡访问。
通常网络策略拒绝更常见的表现是超时或拒绝连接,但某些网关或安全策略会用404隐藏资源。不要为了验证而临时把端口开放到全部公网地址。若确需调整安全组,应先导出或记录现有规则,只增加负载均衡所需的最小来源和端口,验证完成后保留变更记录;回滚时删除对应新增规则,不要覆盖整套安全组。
修复后的验证顺序
修复完成后,先从后端本地验证,再从后端私网地址验证,最后观察负载均衡状态。推荐顺序如下:
- 使用与健康检查完全相同的协议、端口、路径、Host和方法请求后端。
- 确认Nginx访问日志和应用日志中出现了预期请求。
- 检查所有香港云服务器后端,而不是只测试一台。
- 在负载均衡控制台等待一个完整检查周期,观察健康状态变化。
- 确认负载均衡前端业务请求仍能正常转发。
- 查看连续失败次数、响应时间和状态码,而不只看“健康/不健康”两个结果。
- 如果启用了滚动发布,确认新旧版本使用相同的健康路径和Host规则。
一个合格的健康检查结果至少应满足:
- 目标端口是预期服务在监听。
- 请求路径在所有后端一致存在。
- 返回稳定的2xx状态码。
- 不依赖用户登录状态或浏览器Cookie。
- 不因后端业务页面、跳转或静态资源变化而频繁波动。
- 检查请求能在设定超时时间内完成。
- 多台后端的响应状态和路径处理一致。
复测后的持续观察
404修复后仍应保留一段时间的访问日志和负载均衡监控,特别是在应用发布、Nginx配置同步、容器重建或后端扩容之后。健康检查接口看似简单,但最容易因路由前缀、虚拟主机、端口映射和版本差异发生配置漂移。
后续新增香港云服务器时,可以把健康检查请求写入上线验收项:逐台确认后端地址、端口、Host、GET响应和日志记录,再加入负载均衡池。若业务同时存在HTTP和HTTPS入口,也应分别验证对应端口和SNI,不要用一个入口的测试结果代替另一个入口。
当监控再次出现404时,优先回到“负载均衡实际发了什么请求、哪一层记录了这次请求、哪一层生成了响应”这三个问题。只要能固定请求参数并确定404产生位置,通常就能在负载均衡配置、Nginx虚拟主机、路径改写和应用路由之间快速缩小范围。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6818.html



