Vue 博客在浏览器内切换页面时可能正常,但直接刷新文章地址却出现404。这通常和服务器的路径处理有关:浏览器路由认识文章地址,Nginx 还需要知道这条请求应该交给谁。
文章列表路由直接打开时的实际页面。 本站截图,2026 年 10 月 11 日。
为不同请求指定明确去向
本站把公开页面请求交给后端生成初始 HTML;脚本、样式等构建资源由 Nginx 读取静态文件;API 交给业务服务;上传目录提供图片。这样可以单独设置缓存和错误处理,而不是所有路径都返回同一个页面。
传统静态 SPA 常用 try_files 将前台路由回退到 index.html。但如果对所有请求都这样处理,一个不存在的 JavaScript 文件也可能拿到 HTML 和200状态。页面随后报语法错误,真正的文件丢失问题反而被掩盖。
本站页面回退为什么交给后端
文章详情必须查询公开文章,存在时输出正文,不存在或尚未公开时返回404。这种判断不是静态首页文件能完成的。本站让页面路径进入后端页面渲染服务,由它返回正确内容和状态。
对应的简化思路如下,实际配置仍需保留本站已有的资源、上传和 API 路由:
location / {
try_files $uri @site_html;
}
location @site_html {
proxy_pass http://127.0.0.1:3007;
}
API 前缀是否保留,要和应用挂载路径一致
代理配置中的结尾斜杠会影响路径映射。不要凭习惯复制另一项目的配置,先确定应用实际接收的是 /api/articles 还是 /articles,再检查 Nginx 发给它的路径。能返回 JSON,也应核对是否命中了正确接口。
网站根目录里的验证文件则应该作为真实静态文件读取,而不是被页面回退替换。文件验证要求的是原始内容;返回一张好看的首页,即使状态为200,也无法完成验证。
修改配置之后如何检查
先运行 nginx -t,通过后再 reload。接着分别请求首页、一个真实文章地址、一个不存在的文章地址、脚本文件和 API。它们应返回各自正确的内容类型和状态码。
尤其要检查直接访问深层地址,不能只在首页点击后判断配置正确。服务器路由和浏览器路由是两套机制,部署验收需要覆盖两者。
参考:[Nginx try_files 文档](https://nginx.org/en/docs/http/ngx_http_core_module.html#try_files)。
页面、静态资源和 API 的分流示例
下面是说明检查方法或实现思路的示例。路径、参数和环境需要核对后再使用。
静态资源 → 文件 → API → 后端接口 → 页面 → 初始 HTML# 简化示例:合并进现有 server,勿覆盖已有 TLS、后台和上传规则
location /assets/ {
try_files $uri =404;
expires 1y; # 仅适用于文件名带内容哈希的构建资源
}
location /api/ {
proxy_pass http://127.0.0.1:3007; # 保留 /api/ 前缀
proxy_set_header Host $host;
}
location / {
try_files $uri @site_html;
}
location @site_html {
proxy_pass http://127.0.0.1:3007;
proxy_set_header Host $host;
}
# 保存后先 nginx -t,通过再 systemctl reload nginx
延伸资料
继续阅读