You need to enable JavaScript to run this app. Vue项目本地链接可正常访问,部署后访问路由提示404文件或目录未找到
优惠活动
大模型
产品
解决方案
定价
更多

Vue项目本地链接可正常访问,部署后访问路由提示404文件或目录未找到

问题根因
  • 本地开发环境的内置兜底:Vue CLI/Vite 自带的开发服务器默认开启了单页应用(SPA)路由回退能力,不管你访问什么前端路由路径,只要不是静态资源请求,都会统一返回根目录的 index.html 文件,让前端的 Vue Router 接管路径匹配逻辑,因此本地点击 /students 这类路径可以正常渲染页面。
  • 生产服务器的默认处理逻辑:部署到线上后,你当前使用的服务器(从报错格式可判断为 IIS)没有配置 SPA 回退规则。此时点击 href="/students" 的链接,浏览器会直接向服务器发起 GET /students 的资源请求,服务器会在站点目录下查找对应路径的真实实体文件/文件夹。由于单页应用的所有路由都没有对应的独立实体文件,服务器找不到匹配资源,就会抛出 404 错误。
  • 你观察到本地和线上a标签代码完全一致,只是表面现象——两个环境的服务器对同一路径的处理逻辑完全不同,才是结果出现差异的核心原因。
修复方案

1. 必做:配置服务器的SPA路径回退规则

这是使用Vue Router history模式的标准要求,根据你使用的服务器类型配置对应规则即可,核心逻辑是:当服务器找不到请求路径对应的真实文件时,统一返回 index.html 让前端路由接管。

  • 如果你使用的是IIS(匹配你当前的报错场景):在站点根目录新增 web.config 文件,写入URL重写规则:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="SPA Fallback" stopProcessing="true">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="/index.html" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>
  • 如果你使用的是Nginx:在站点配置块中添加回退规则:
location / {
    try_files $uri $uri/ /index.html;
}
  • 如果你使用的是Apache:在站点根目录的 .htaccess 文件中添加对应的回退重写规则即可。

2. 前端体验优化(推荐)

你当前导航栏直接使用原生 <a> 标签硬编码 href 的写法,点击链接会触发浏览器整页刷新,和单页应用的无刷新跳转体验不匹配。可以直接替换为 Vue Router 提供的 <router-link> 组件,实现无刷新路由跳转,也避免路径硬编码带来的维护问题:
将 Header.vue 中的a标签替换为:

<router-link v-if="list.dropdown === false" :to="list.link">{{ list.name }}</router-link>

注意:只要服务器配置了正确的回退规则,你原来的原生a标签写法也能正常访问页面,只是会有整页刷新的体验损耗,不是导致404的核心原因。

3. 无服务器权限的兜底方案

如果你的部署环境没有权限修改服务器配置(比如共享主机权限受限),可以将 Vue Router 的配置从 history 模式切换为 hash 模式。切换后所有路由路径都会带上 # 标识(例如 /students 会变为 /#/students),服务器只会解析 # 前面的路径部分,永远只会请求根目录的 index.html,不会因为路径匹配抛出404。这个方案的缺点是URL美观度不足,但不需要修改任何服务器配置。

内容的提问来源于stack exchange,提问作者Steve

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 09:06:03