Flask脚本无法加载templates目录下login.html的问题求助

已确认背景 #

• 技术栈：Flask + SQLite3
• 问题：尝试加载templates目录下的login.html，页面无法正常打开
• 已尝试操作：更换端口、检查Windows防火墙、编写简化测试代码、以管理员身份运行VSCode
• 运行状态：终端显示Flask服务启动成功，但访问对应URL时页面无法加载

核心排查步骤 #

1. 核对Flask初始化与路由配置 #

确保脚本正确设置Flask实例和路由，示例如下：

from flask import Flask, render_template
app = Flask(__name__)  # 关键：__name__让Flask自动识别根目录下的templates文件夹

@app.route('/login')  # 访问路径需与该路由严格匹配
def login_page():
    return render_template('login.html')  # 文件名和路径不能出错

if __name__ == '__main__':
    app.run(debug=True)  # 开启debug模式，强制显示详细错误日志

如果脚本不在项目根目录，手动指定模板路径：

# 示例：脚本在src/目录，templates在项目根目录
app = Flask(__name__, template_folder='../templates')

2. 检查目录结构是否合规 #

Flask对模板目录的位置和名称有严格要求，必须符合如下结构（注意大小写，Windows下也不能写错）：

你的项目文件夹/
├── app.py  # Flask运行脚本
└── templates/
    └── login.html  # 必须直接放在templates目录内，不能嵌套子目录（除非路由显式指定）

• 确认templates拼写正确（别写成template、Templates）
• 确认login.html没有放错位置（比如误放到脚本同级目录）

3. 查看Debug模式下的错误日志 #

开启debug=True后，访问页面时终端会输出详细错误信息：

• 若显示404：检查浏览器地址栏的URL是否和路由一致（比如路由是/login，就要访问http://127.0.0.1:5000/login，而非根路径/）
• 若显示500：根据终端的异常信息修复（比如模板语法错误、SQLite3连接失败、变量未定义等）

4. 用浏览器开发者工具排查请求 #

按F12打开浏览器开发者工具，切换到「网络」标签页后刷新页面：

• 查看请求状态码：404→路由不匹配；500→服务器内部错误；200但页面空白→模板渲染问题（比如无内容、静态资源加载失败）
• 查看响应内容：如果是Flask返回的错误页面，会直接显示问题原因

5. 验证模板本身是否正常 #

创建极简的test.html（内容如<h1>测试页面</h1>）放入templates目录，添加测试路由：

@app.route('/test')
def test():
    return render_template('test.html')

访问/test如果能正常显示，说明问题出在login.html本身（比如模板语法错误、引用的静态资源路径错误等）

内容的提问来源于stack exchange，提问作者debug_cat