Nginx微前端路由分发失效的根源是路径语义、请求上下文与响应契约失联；需严格配置location一一映射子应用路径、统一基址、禁用重定向、校验响应头及连接生命周期。
微前端路由分发在 Nginx 层瘫痪，根本不是“转发没配好”，而是基础架构中路径语义、请求上下文和响应契约三者彻底失联。Nginx 在这里不是代理网关，而是微前端运行时的“路径仲裁者”——它必须明确知道谁该处理 /admin/、谁该处理 /marketing/、谁该兜底，且不能让任何一层擅自重写或截断路径。
确保 Nginx location 路由与子应用注册路径严格一一映射
每个微前端子应用必须有独立、无重叠、带尾斜杠的 location 块，且禁止用正则模糊匹配或嵌套通配：
- /admin/ → 对应 admin 子应用：必须用 alias + try_files，且 fallback 指向该子应用的 index.html（如 /admin/index.html）
- /marketing/ → 对应 marketing 子应用：同理，alias 指向其 dist 目录，try_files fallback 写成 /marketing/index.html
- 禁止 location / { ... } 兜底所有请求：这会覆盖子应用的精确匹配，导致主应用接管了本该由子应用处理的 /admin/api 请求
- 所有 location 必须显式声明 proxy_http_version 1.1 和 Connection header：避免 HTTP/1.0 兼容逻辑干扰微前端间 iframe 或 fetch 的连接复用
统一各子应用的构建与运行时路径基址
每个子应用的 publicPath、router base、API base URL 必须与 Nginx 的 location 路径完全一致，且含前后斜杠：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- Vue 子应用：publicPath: '/admin/', router.base = '/admin/'，fetch 请求前缀为 '/admin/api/'
- React 子应用（使用 @micro-frontends/react-router）：basename 设为 '/marketing/'，且所有 useNavigate 调用不拼接绝对路径
- 主应用 qiankun registerMicroApps 中的 entry 字段，必须指向 Nginx 暴露的完整路径（如 'http://host/admin'），而非本地开发地址
- 所有子应用构建产物中的 HTML link/script 标签 href/src 必须以 /admin/ 开头，否则资源加载 404
禁用 Nginx 自动重定向与隐式 rewrite
Nginx 默认行为（如 autoindex、directory traversal 阻断、或未设 index 的 location 返回 301）会破坏微前端单页特性：
立即学习“前端免费学习笔记（深入）”；
- 删除所有 location 块中不必要的 rewrite 指令，尤其避免 ^/admin(.*)$ → /admin/$1 这类冗余重写
- 关闭 autoindex on；防止目录列表暴露或触发意外跳转
- 每个子应用 location 中显式设置 index index.html；并用 try_files $uri $uri/ /admin/index.html;（注意 fallback 路径与 location 一致）
- 禁用 server_name_in_redirect on；避免 Nginx 根据 Host 自动补全跳转地址，导致跨子应用跳转时路径错乱
校验响应头与连接生命周期一致性
微前端常通过 fetch 加载子应用 JS、HTML、CSS，Nginx 必须保证这些响应可被浏览器正确解析且连接不被提前中断：
- 检查后端服务返回的 Content-Type 是否准确（text/html、application/javascript 等），避免因 header 缺失冒号或含非法字符导致 Nginx 缓冲卡死
- 对静态资源 location（如 /admin/static/）启用 gzip_static on; 并确保 .gz 文件存在，避免 Nginx 回退到动态压缩引发延迟
- 设置 proxy_buffering off; 仅用于子应用 HTML 入口文件（非 API），防止 Nginx 解析 malformed header 时阻塞整个 worker
- 调整 keepalive_timeout 与 upstream 的 connection timeout 对齐，避免 Node.js 微前端服务主动关闭连接而 Nginx 还在复用旧连接
