运行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 viewsmain.py简化为:from app import app if __name__ == "__main__": app.run(debug=True) - 检查文件读取权限
如果你使用的是Linux/macOS系统,确认运行项目的用户拥有app/templates目录以及内部index.html文件的读取权限,权限不足也会触发找不到模板的报错。
内容的提问来源于stack exchange,提问作者Hossam Fid
相关产品推荐
相关产品推荐

