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
相关产品推荐
相关产品推荐

