nginx 不导致路由置空，而是其代理配置与前端异步微任务时序错位，暴露了前端本就存在的脆弱逻辑，如 history 模式未配 try_files、路由守卫中未处理异步拒绝、静态资源路径与 base url 不一致等。
这个问题本质不是 Nginx “导致”路由置空，而是 Nginx 代理配置与前端异步微任务（如 Promise.then、MutationObserver、requestIdleCallback）在特定条件下产生时序错位，间接暴露了前端代码中本就存在的脆弱逻辑。Nginx 不执行 JS，也不干预微任务队列，但它会影响响应到达时机、连接状态和资源加载顺序，从而让某些边界问题浮出水面。
确认是否真由代理引发——先排除前端自身缺陷
很多所谓“代理后路由置空”，实际是 Vue/React 应用在 history 模式下未正确配置 try_files，或路由守卫中存在未处理的异步拒绝（unhandled rejection），在开发服务器（如 Vite 的 dev server）里被静默吞掉，而 Nginx + 静态部署环境会暴露它。
- 打开浏览器 DevTools → Console，勾选“Pause on caught exceptions”和“Pause on uncaught exceptions”，刷新页面，看是否在 JS 执行中途暂停
- 检查 Network 面板：所有 JS 文件（尤其是
app.js、vendor.js）是否都返回 200？有无 404 或 MIME 类型错误（如 JS 被当成 text/plain 返回）？ - 在入口 HTML 中加一段内联脚本：
<script>console.log('HTML loaded');</script>，确认 HTML 渲染流程是否卡在 JS 加载前 - 临时把路由模式从
history切为hash，再部署测试——若空白消失，说明根因是 history 模式 + Nginx 路由回退配置缺失，而非“异步微任务穿透”
检查 Nginx 对响应流与连接生命周期的干扰
当后端返回的是 SSE、长轮询响应，或前端通过 fetch().then() 等链式调用依赖响应头/连接状态做后续跳转时，Nginx 默认缓冲和超时行为会截断、延迟甚至伪造关键信号。
- 确认 location 块中已设置：
proxy_buffering off;、proxy_http_version 1.1;、proxy_set_header Connection '';、proxy_read_timeout 300; - 若后端响应含
Content-Type: text/event-stream或自定义流类型，确保 Nginx 未启用缓存：proxy_cache off;、proxy_cache_bypass 1; - 检查是否有
auth_request指令嵌套在该 location 中——它强制同步等待子请求完成，会阻塞整个响应流，导致前端接收不完整响应体，进而使基于响应数据的微任务（如解析 JSON 后跳转）无法触发
验证静态资源路径与 base URL 是否一致
Vue CLI 或 Vite 构建时若设了 base: '/subpath/'，但 Nginx 的 root 或 alias 未对齐，会导致 JS 加载后发起的异步请求（如 API 调用、动态 import）地址错误，Promise 拒绝后未被捕获，应用挂起且无提示。
- 查看页面源码中
<script src="/assets/index.xxxx.js"></script>的路径是否可访问；对比 Network 面板中该 JS 文件的真实请求 URL 和响应状态 - 检查 JS 文件内容，搜索
__webpack_public_path__或import('./xxx')动态导入路径，确认其拼接逻辑是否受 Nginx 的 URI 重写影响 - 在 Nginx 的
location /块中显式设置root /path/to/dist;，避免使用alias引发路径映射歧义
禁用可能干扰事件循环的模块与日志
某些 Nginx 模块或高频率日志写入会在 worker 进程中引入不可预测的延迟，间接拉长 JS 执行准备时间窗口，使依赖精确时序的微任务（如竞态判断、防抖重试）失效。
- 临时注释掉该 location 下所有
rewrite、if、map指令，简化匹配逻辑 - 将 access_log 改为缓冲写入：
access_log /var/log/nginx/app.log buffer=64k flush=5s;，避免磁盘 I/O 拖慢响应首字节时间 - 确认未启用
sub_filter或第三方模块（如 headers-more）对响应体做同步文本替换——它们会破坏流式传输，也增加处理延迟
