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

