You need to enable JavaScript to run this app. Flask环境下使用XMLHttpRequest请求test.html返回404问题
优惠活动
大模型
产品
解决方案
定价
更多

Flask环境下使用XMLHttpRequest请求test.html返回404问题

核心问题本质
  • Flask 框架默认仅会为路由列表中显式注册的路径返回响应:templates文件夹是专为render_template渲染逻辑设计的模板存储目录,框架不会为这个目录下的物理文件自动生成可通过浏览器/AJAX直接访问的URL路由。
  • 你当前项目只注册了/这一个路由,无论你请求test.html、templates/test.html还是其他任意未注册的路径,服务端都会因为匹配不到对应规则返回404,这和你写的文件相对/绝对路径是否正确没有关系,是路由映射逻辑和本地磁盘文件路径没有做绑定导致的。

可直接落地的解决方式

方案1:不调整现有目录结构,为test.html显式注册路由

在现有app.py中新增对应路由,直接通过模板渲染返回test.html内容:

# 原有代码基础上追加路由定义
@app.route('/test.html')
def return_test_page():
    return render_template('test.html')

修改完成后,把AJAX代码里的请求路径改回'test.html',重启Flask服务后,请求会正确匹配到对应路由返回200。

注意:此时请求的完整URL是http://127.0.0.1:5000/test.html,不是templates/test.html,除非你专门给templates/test.html这个路径单独注册路由,否则这个地址永远会返回404。

方案2:按Flask规范调整文件存放位置,利用默认静态资源规则

如果不想为每个静态请求的文件单独写路由,可以按照Flask的默认资源规则调整目录结构,把需要前端直接请求的文件移到独立的静态资源目录:

|--static
|  |--test.html  # 从templates目录移到这里
|--templates
|  |--index.html
|--app.py

调整后无需修改Flask初始化逻辑,框架会自动为/static/路径下的所有文件生成可访问路由,此时把AJAX的请求路径改成'/static/test.html'即可正常发起请求。

排查时的常见注意点

  • 不要把本地磁盘的物理目录结构直接等同于Web服务的URL路径:URL到文件内容的映射必须经过服务端路由规则匹配,和直接本地双击打开html文件的运行逻辑完全不同,这也是多数新手在Flask下做AJAX请求踩404的核心原因。
  • 修改app.py的路由配置后,必须重启Flask开发服务器,否则新增的路由规则不会被加载生效。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 12:54:03