前端路由刷新 404:从 devServer 到 Nginx 的完整排查路径
单页应用用 history 模式上线后,用户点进二级页面再按 F5,浏览器直接返回 404,这是很常见的部署问题。它通常不是前端代码写错了,而是请求路径 /user/123 被服务器当成了真实目录或文件去查找,服务器找不到对应资源就返回 404。在本地开发时 Vite 或 webpack-dev-server 已经帮我们做了 fallback,所以不容易暴露;一旦把 dist 目录丢到 Nginx、Node 静态服务或云函数上,路由接管逻辑缺失,页面就直接挂了。下面从浏览器请求路径、开发服务器配置、生产环境静态服务配置以及 Node 中间件几个层面,把这个问题拆开看一遍,并给出可以直接落到项目...