运行Flask应用时页面加载空白的问题求助

算力阿峰

2026-7-13

Flask页面空白问题排查方案

确认目录结构正确性
严格按照Flask要求检查项目结构，templates文件夹必须和主程序文件同级，且名称为全小写：
```
项目根目录/
    主程序文件.py
    templates/
        components.html
```
大小写错误会导致Flask无法识别模板目录。
开启调试模式定位错误
修改主程序启用调试模式，运行时若存在模板加载问题会直接显示错误信息：
```
from flask import Flask, render_template
app = Flask(__name__)

@app.route('/')
def home():
    return render_template('components.html')
if __name__ == '__main__':
    app.run(port=5100, debug=True)
```
重启服务后访问页面，若出现TemplateNotFound错误，说明模板路径存在问题。
检查HTML资源引用
直接打开HTML正常显示但Flask渲染空白，大概率是HTML中本地资源（CSS/JS/图片）的路径问题。直接打开时浏览器能读取本地路径，但通过Flask服务访问时需使用正确的相对路径或Flask静态资源引用方式：
比如将静态文件放在同级static目录下，引用时应写：
```
<link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
```
排查HTML内容问题
先简化components.html内容，比如只保留一行测试文本：
```
<h1>测试渲染</h1>
```
重启服务后如果能正常显示，说明原HTML文件存在语法错误（未闭合标签、错误模板语法等），逐步排查原文件内容。