核心是验证请求精准命中、资源正确加载、路由不互相干扰，需覆盖请求入口、路径解析、文件定位、前端行为和日志反馈的闭环流程，重点检查Nginx location匹配逻辑、前后端路径一致性及真实路径行为。
测试复杂路径映射在多业务线独立部署时的兼容性，核心是验证“请求能精准命中、资源能正确加载、路由不互相干扰”。这不是一次性的配置检查，而是一套覆盖请求入口、路径解析、文件定位、前端行为和日志反馈的闭环验证流程。
构造真实请求场景，覆盖所有业务路径前缀
不能只用 curl /admin/ 或 /api/v2/users 简单试探。要模拟各业务线典型访问模式：
- SPA 应用：访问 /admin/dashboard（触发 HTML 兜底）、/admin/static/js/app.js（命中静态资源）、/admin/login?next=/dashboard（带查询参数）
- API 接口：调用 /api/payment/create（proxy_pass 转发）、/api/payment/（末尾斜杠是否重定向）、/api/（确保不被其他 location 拦截）
- 混合路径：如 /static/logo.png（本地 serve）、/static/（目录索引）、/user/profile（另一 SPA 子应用）
逐条检查 Nginx 配置的实际匹配逻辑
Nginx 的 location 匹配有严格优先级（精确匹配 > 最长前缀 > 正则），多业务共存时极易因顺序或写法导致误匹配。重点确认：
- 所有业务路径 location 块是否显式以 / 结尾（如
location /admin/ { ... }），避免location /admin意外捕获/administer - 正则 location（如
location ~ ^/v\d+/）是否加了^和$边界控制，防止跨业务匹配 -
try_files中的兜底路径是否与 alias 或 root 逻辑一致（例如 alias /var/www/admin/ → 兜底必须是/admin/index.html，不是/index.html）
验证后端服务与前端资源的协同一致性
路径映射只是第一层，前后端配合不到位，照样 404 或白屏：
- 前端构建时，Vue 的
publicPath或 React Router 的basename必须与 Nginx 的 location 前缀完全一致（如 Nginx 是/report/，前端就必须设为"/report/"） - API 请求的 base URL（如 axios.defaults.baseURL = "/api/"）应与 Nginx 中
location /api/对齐，避免浏览器发出/api/user却被转发到错误 upstream - 检查浏览器开发者工具 Network 面板：所有 JS/CSS/图片请求状态码是否为 200；XHR 请求是否返回预期数据，而非 404 或 502
借助日志和调试输出定位真实路径行为
光看返回结果不够，必须确认 Nginx 实际读取/转发的是哪个文件或地址：
- 临时开启
error_log /var/log/nginx/debug.log debug;，然后发起请求，查看日志中类似open() "/var/www/admin/static/js/app.js" ...或proxy http://127.0.0.1:3001/api/user的真实路径 - 在关键 location 块中加入
add_header X-Debug-Location "admin";，用 curl -I 查看响应头，快速确认请求落入哪个业务分支 - 对 proxy_pass 场景，在 upstream 后端服务日志中反查收到的
Host和Request-URI，确认 Nginx 是否透传了原始路径（如未 strip /api/ 前缀，后端会收到 /api/user 而非 /user）
