React history 路由刷新报 404 Nginx 回退规则该怎么写

ReaCt 项目用 BrowserRouter,本地刷新没问题,部署到 Nginx 上点进 /orders/1024 再按 F5 就是 404,页面上是 Nginx 自己的错误页,不是 React 白屏,说明请求根本没进前端。

history 模式的路径是假的,浏览器会真去请求 /orders/1024,磁盘上没这个文件。加 try_files $uri $uri/ /index.html 就好。麻烦的是加上之后接口出问题:/api/orders 也被回退成 index.html,axios 报 Unexpected token '<',状态码还是 200,监控看不出来。

顺序要靠匹配规则保证。location /api/ 写在 location / 前面并不管用,Nginx 前缀匹配不看书写顺序,长度优先,/api/ 本来就赢过 /。但以后有人加一条正则 location ~ \.php$,正则优先级更高,接口又会被抢走。我用 ^~ 显式锁住 /api/。

Express 那边也踩了一次。老代码是 app.get('*', ...),升到 Express 5.0 启动就抛 TypeError: Missing parameter name at 1,path-to-regexp 不再接受裸星号,得写 app.get('/*splat', ...) 或者干脆用 app.use 兜底。这个报错跟路由本身没关系,光看日志容易懵。

location ^~ /api/ {
    proxy_pass http://127.0.0.1:8080;
}

location / {
    root /data/www/react;
    try_files $uri $uri/ /index.html;
}

验证别只 curl 首页。curl -I https://site.com/orders/1024 要 200 且 Content-Type 是 text/html;curl -I https://site.com/api/orders 要 401 或 200 的 application/json。两个同时对了,回退才算配对。

还有个小细节:带后缀的静态资源不要回退。加一条 location ~* \.(js|css|png|woff2)$ 走 expires,拼错的资源名会老实返回 404,而不是伪装成 200 的 HTML。

您可以还会对下面的文章感兴趣: