Vue 3项目部署到日本服务器后,刷新子页面出现404怎么解决?

发布人:A5数据发布时间:2026-11-15 13:45阅读量:22

Vue 3 项目部署到日本服务器后,点击站内链接可以打开子页面,但刷新或直接访问该页面时返回 404,通常是前端路由使用了 History 模式,而 Web 服务器没有把未匹配的页面路径交给应用入口 index.html。这不是日本机房特有的问题;要修复的是实际接收请求的 Nginx、Apache、Caddy 或 CDN 回源配置。

先确认 404 是谁返回的:如果响应内容是服务器默认错误页,优先检查 Web 服务器路由和站点目录;如果页面能正常加载 Vue 外壳,只显示应用内的“页面不存在”,则应检查 Vue Router 的路由定义和基础路径。不要一开始就改防火墙或重装项目,先从请求链路和配置位置逐层缩小范围。

一、确认故障现象

用浏览器打开一个出现问题的子页面,例如 https://example.jp/products/42,记录以下结果:

  • 站内点击该页面是否成功,页面刷新后是否变成 404。
  • 直接在新标签页输入完整地址,是否同样报错。
  • 404 是浏览器展示的服务器错误页,还是 Vue 应用自己的错误页面。
  • 页面本身是否打开,但 JavaScript、CSS 或图片请求失败。

如果只有刷新和直接访问失败,而站内点击正常,History 模式回退通常是首要检查项。站内点击时,Vue Router 可以在浏览器端切换页面;刷新时,浏览器会向服务器请求 /products/42。服务器若只查找磁盘上的同名文件或目录,就可能返回 404,而不会自动返回 Vue 应用入口。

一、确认故障现象配图

如果子页面和首页都打不开,或静态资源也返回 404,就不能只归因于路由回退,需要继续检查域名、站点目录、部署产物和 CDN 回源。

二、从外到内检查请求去了哪里

1. 确认域名和 CDN 实际指向

先确认访问的域名解析到了预期的日本服务器或 CDN。域名接入 CDN 时,浏览器请求可能先到 CDN,再由 CDN 转发到源站;服务器配置正确,并不代表 CDN 当前使用的源站、端口和回源协议也正确。

可以先查看 DNS 解析结果:

dig +short example.jp

如果没有安装 dig,可使用系统已有的 DNS 查询工具,或在域名服务商控制台核对解析记录。这个结果只能说明 DNS 返回的地址,不能单独证明最终请求一定到达该主机。

如果可以直接访问源站,可用 curl --resolve 保留域名和 HTTPS 主机名,同时把请求定向到指定 IP:

curl --resolve example.jp:443:203.0.113.10 \
  -sS -D - -o /dev/null \
  https://example.jp/products/42

将示例 IP 换成自己的源站地址。若源站返回正常、经 CDN 访问却返回 404,检查 CDN 的回源地址、回源 Host、缓存规则和边缘规则;如果源站也返回 404,继续检查源站 Web 服务。部分源站只允许 CDN 地址访问,无法从本机直连,这种情况下应在服务器日志或 CDN 回源日志中核对请求,而不是把连接失败直接判断成配置错误。

二、从外到内检查请求去了哪里|1. 确认域名和 CDN 实际指向配图

2. 读取响应状态和服务端日志

用 curl 检查页面状态码与响应头:

curl -sS -D - -o /tmp/vue-route.html \
  https://example.jp/products/42

重点关注状态码、Server 等响应头,以及保存的页面内容。响应头不一定能准确识别错误来源,但可以与浏览器表现、CDN 日志和源站访问日志交叉判断。

在常见的 Debian 或 Ubuntu Nginx 环境中,可查看最近的访问和错误日志:

sudo tail -n 50 /var/log/nginx/access.log
sudo tail -n 50 /var/log/nginx/error.log

如果日志路径不同,应以站点配置中的 access_log 和 error_log 为准。访问日志中出现该路径且状态为 404,说明请求到达了这台 Nginx,但还需确认是哪一个 server 配置接管请求;若源站日志完全没有对应请求,应回头检查 CDN、负载均衡或域名指向。

三、检查 Vue 路由模式和部署路径

确认项目是否使用 History 模式。Vue Router 4 常见写法如下:

import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    // 项目路由
  ],
})

export default router

使用 createWebHistory() 时,服务器需要为前端页面路径配置入口回退。若项目使用 createWebHashHistory(),URL 通常带有 #,# 后的部分不会作为路径发送给服务器;这类项目一般不需要为这些前端路径配置 History 回退,但仍要确保静态资源路径正确。

再核对项目部署在域名根目录还是子目录。若站点部署在 https://example.jp/,Vite 通常使用根路径基础配置;若部署在 https://example.jp/app/,构建资源基础路径和 Vue Router 的 history base 应保持一致。例如:

// vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  base: '/app/',
})

路由创建时使用 import.meta.env.BASE_URL,可让路由基础路径与 Vite 配置联动。若页面路径本身位于 /app/,但构建产物仍把资源指向 /assets/...,页面可能出现白屏或资源 404;反过来,资源路径正确但服务器没有为 /app/... 配置回退,也会出现刷新 404。修改配置后要重新构建并部署新的产物,单改服务器配置不会修正已经生成的资源路径。

四、检查 Nginx 站点目录与回退规则

先确认实际生效的 Nginx 配置,而不是只查看某个看起来相关的文件:

sudo nginx -T

该命令会输出合并后的配置。检查域名对应的 server_name、监听端口、root、index、location 和日志路径。输出可能包含内部域名或其他敏感配置,不要未经处理就公开粘贴。

确认 root 指向的是 Vue 构建产物所在目录,而不是项目源码目录。例如,若构建产物为 /var/www/example/dist/index.html,站点根目录才应与实际部署结构对应。可用以下命令核对文件是否存在:

ls -l /var/www/example/dist/index.html

如果入口文件不存在,先检查构建是否成功、部署是否完整、发布目录是否一致。此时增加回退规则也无法解决目录错误。

对于部署在域名根目录、由 Nginx 直接提供静态文件的常见场景,站点配置可参考:

server {
    listen 80;
    server_name example.jp www.example.jp;

    root /var/www/example/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

HTTPS 站点也要在实际处理 443 请求的 server 配置中确认相应的站点根目录和回退规则。若 80 端口只负责跳转到 HTTPS,而浏览器最终访问的是 443,就只修改 80 端口配置不会修复 HTTPS 下的 404。

try_files 的含义是:先尝试请求对应的文件,再尝试目录;都不存在时,将请求交给 index.html。这样 /products/42 不必对应磁盘上的真实文件,Vue Router 可以在浏览器端解析路径并展示页面。

如果配置中已有 location /,应检查并调整该段,而不是盲目新增重复的 location /。Nginx 的 location 匹配顺序会影响请求实际进入哪段规则;其他精确匹配或更具体的路径规则也可能使请求绕过通用回退。

API 和静态资源要避免被错误回退

有后端 API 时,API 路径应由对应的代理或后端规则处理,不能把本应返回 API 404 的请求一律改成 Vue 首页。示意配置如下:

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

location / {
    try_files $uri $uri/ /index.html;
}

这只是示例。实际端口、路径前缀和 proxy_pass 写法要与后端路由约定一致;如果后端要求去掉 /api/ 前缀,需按该约定调整代理目标。修改前应先记录原配置,并确认不会覆盖已有的 API、鉴权或限流规则。

还要验证静态资源。若请求 /assets/app.js 时服务器把不存在的文件也回退成 index.html,浏览器可能报 MIME 类型错误、脚本解析错误,或者出现看似“页面打开但内容空白”的问题。检查浏览器开发者工具的 Network 面板,确认 JS 和 CSS 请求返回的是实际文件,而不是状态为 200 的 HTML 页面。对缺失的静态资源保留明确的 404,通常比把所有路径都伪装成首页更容易发现部署不完整。

/api/... → 对应代理或后端规则;存在的 /assets/app.js → 返回实际静态文件;缺失的静态资源 → 保留明确 404;前端页面路径 /pr

五、按结果选择修复方向

检查结果优先判断下一步
首页正常,子页面刷新返回 Nginx 404History 路由没有回退,或请求进入了错误的 server/location检查 443 站点配置、root 和 try_files
源站正常,经 CDN 访问返回 404CDN 回源或缓存层与源站行为不一致核对回源 Host、源站地址、缓存规则;配置修正后按需清理对应缓存
子页面返回 200,但显示 Vue 自定义 404服务器已返回应用入口,路由未匹配或基础路径不一致检查路由表、history base 和子目录部署配置
页面 HTML 正常,JS/CSS 返回 404构建资源路径、发布目录或静态资源规则错误检查 Vite base、部署文件及 Network 请求路径
API 请求也返回 Vue 首页API 路径被前端回退规则接管检查 API 专用 location 与代理路径
首页和子页面都返回 404域名、虚拟主机或站点根目录不匹配的可能性更高核对 DNS、server_name、监听端口和 root

表中的判断是排查优先级,不是仅凭一个状态码就能下结论。尤其是 CDN、多个 Nginx server 块或负载均衡环境,应同时比较客户端响应和源站日志。

六、安全应用配置并验证

修改前先确认配置文件路径,并备份将要调整的文件。以下命令适用于已确认配置文件路径的 Linux 环境;示例路径需要替换为实际文件:

sudo cp -a /etc/nginx/sites-available/example.jp.conf \
  /etc/nginx/sites-available/example.jp.conf.bak

如果配置由面板、容器编排或自动化发布工具管理,应通过对应管理方式修改,避免手动改动随后被覆盖。只改与该站点相关的规则,不要为解决一个路由 404 顺带改文件权限、关闭安全策略或覆盖整份 Nginx 配置。

保存后先检查语法:

sudo nginx -t

显示配置测试成功,才适合继续应用;如果提示语法错误或引用的文件不存在,不要 reload,应根据错误行修正配置。确认检查通过后再平滑加载:

sudo systemctl reload nginx

适用前提是系统由 systemd 管理,且 Nginx 服务名为 nginx。若服务由容器或其他方式管理,应使用该环境的受控发布流程,不要照搬服务命令。

随后分别验证首页、子页面刷新、静态资源和 API:

curl -sS -o /dev/null -w '%{http_code}\n' https://example.jp/
curl -sS -o /dev/null -w '%{http_code}\n' https://example.jp/products/42
curl -sS -o /dev/null -w '%{http_code}\n' https://example.jp/assets/app.js

第二条返回 200 只能说明 HTTP 层拿到了成功响应,不代表 Vue 路由一定正确;还要在浏览器中直接访问该子页面并刷新,确认页面内容、控制台和 Network 面板均正常。第三条中的资源文件名应替换为实际构建文件名,因为 Vite 构建文件通常带有变化的哈希。

若配置测试失败,或应用后出现新的 404、API 异常,应根据备份恢复原文件,再执行 nginx -t;通过后 reload 恢复服务。不要在未经检查的情况下直接覆盖配置或反复 reload。

七、持续观察并处理缓存差异

修复后至少检查首页、一个常见子页面、一个深层路径、静态资源和 API。再分别从浏览器与命令行访问,留意是否只有某个域名、协议、CDN 节点或服务器实例异常。多台源站部署时,各实例的构建目录和 Nginx 配置都应一致,否则刷新结果可能随负载均衡而变化。

若源站已返回正确内容而 CDN 仍持续返回旧的 404,可在确认缓存规则后,只清理受影响的页面路径或相应缓存键;不要在源站问题未解决时把大范围清缓存当作修复。观察访问日志中的 404 是否下降,同时关注静态资源和 API 是否出现新的异常。这样既能确认 History 回退真正生效,也能避免把服务器错误页、Vue 应用内路由错误和 CDN 缓存问题混为一谈。

A5idc数据面向日本及跨境业务提供物理服务器资源,热销系列涵盖Xeon Gold、AMD EPYC平台与NVMe存储,CTG系列则提供SSD、大容量HDD、多IP及CIA、GIA、CN2、SoftBank等线路选项。网站前端、业务后台和接口服务可结合不同的计算、存储与网络方案部署,为Vue 3项目在日本运行提供相应的基础资源。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9640.html

相关推荐