Vue.js 中使用 Axios 请求 HTML 文件返回404 其他文件类型可正常获取
问题核心诱因
这个问题和Axios的请求逻辑没有任何关系,本质是Vue开发阶段本地dev服务器的静态资源访问规则导致的:
- Vue CLI 启动的开发服务器(基于webpack-dev-server)默认不会把
src源码目录下的原始文件映射成可公开访问的静态资源,所有静态文件的访问逻辑会被编译流程、SPA路由规则接管。 - 当请求路径指向
.txt/.css/.js后缀的文件时,开发服务器没有内置的拦截规则,会顺着文件系统实际读取文件内容返回,这也是你改文件后缀为txt就能正常读取的原因;但碰到.html后缀的请求时,会优先触发SPA路由的兜底匹配逻辑——只要请求的html路径没有对应配置的前端路由规则,就会直接返回404,根本不会真的去文件系统定位你存在src/library下的原始html文件。 - 你现在写的
/src/library/test.html本质是开发环境下的虚拟路径,哪怕现在不报错,等项目打包上线后这个路径也完全不存在——生产环境的静态资源都是webpack编译后的带hash值的输出文件,和源码目录的结构没有任何对应关系。
可落地的解决方案
- 最合规的长期方案:把需要读取的html文件从
src/library目录挪到项目根目录的public文件夹下,比如存放路径调整为public/library/test.html,对应的Axios请求url改成/library/test.html即可。public目录下的所有文件会被开发服务器原封不动映射到网站根路径,不会触发编译流程和路由拦截,所有后缀的文件都可以正常访问。 - 开发环境临时调试方案:如果暂时不想挪动文件,可以在
vue.config.js里给dev服务器补充静态目录映射规则,绕开路由拦截直接把请求路径指向本地实际文件:
// vue.config.js 配置示例 const path = require('path') module.exports = { devServer: { static: { directory: path.join(__dirname, 'src/library'), publicPath: '/src/library' } } }
- 上线注意事项:上述临时配置只在本地开发环境生效,项目打包发布时webpack不会保留
src目录下的原始文件结构,如果不把需要独立读取的静态文件放到public目录,上线后还是会出现404问题。
内容的提问来源于stack exchange,提问作者ALatour
相关产品推荐
相关产品推荐

