You need to enable JavaScript to run this app. Vue.js 中使用 Axios 请求 HTML 文件返回404 其他文件类型可正常获取
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 03:15:04