You need to enable JavaScript to run this app. 运行Flask项目出现jinja2.exceptions.TemplateNotFound: index.html报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

运行Flask项目出现jinja2.exceptions.TemplateNotFound: index.html报错如何解决

Flask TemplateNotFound 异常排查解决方法
  • 修正Flask实例的模板路径配置
    你当前启动脚本main.py在项目根目录,而templates文件夹存放在app子目录下,Flask默认会从启动脚本同级目录查找templates,路径不匹配是本次报错的核心原因。修改main.py中Flask实例初始化代码即可:
    # 修改前
    # app = Flask(__name__)
    # 修改后,显式指定模板文件夹和静态文件夹路径
    app = Flask(__name__, template_folder='app/templates', static_folder='app/static')
    
  • 核对目录与文件命名
    确认app目录下的文件夹命名严格为templates(注意末尾的s,大小写完全匹配,Linux/macOS系统对大小写敏感),同时确认index.html直接存放在templates目录下,没有嵌套在子文件夹中,也没有出现index.htm、index.html.txt这类后缀名错误(Windows系统可开启「显示文件扩展名」确认后缀)。
  • 调整包结构(可选,适合后续扩展)
    如果要使用标准的Flask包结构,可在app目录下新增__init__.py文件,内容如下:
    from flask import Flask
    app = Flask(__name__)
    from app import views
    
    对应的main.py简化为:
    from app import app
    
    if __name__ == "__main__":
        app.run(debug=True)
    
  • 检查文件读取权限
    如果你使用的是Linux/macOS系统,确认运行项目的用户拥有app/templates目录以及内部index.html文件的读取权限,权限不足也会触发找不到模板的报错。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.18 11:54:04