Flask自定义404/500错误处理页面无法显示问题求助

看起来你的自定义错误页面没生效主要有几个核心原因，咱们一步步排查解决：

1. 模板文件夹位置错误（最可能的根因） #

Flask默认会从项目根目录下的templates文件夹加载模板文件，但你把404.html和500.html放在了static/templates里——static目录是专门用来存CSS、JS、图片这类静态资源的，Flask不会主动去这里查找模板文件，找不到模板自然就返回空白页面了。

修复方法： #

把templates文件夹从static里移出来，和你的app.py放在同一层级，最终文件夹结构应该是这样：

你的项目文件夹/
├── app.py
├── templates/
│   ├── base.html
│   ├── 404.html
│   └── 500.html
└── static/
    └── uploads/

2. 500错误处理函数的范围冲突 #

你用了@app.errorhandler(werkzeug.exceptions.HTTPException)来处理500错误，这个装饰器会捕获所有HTTP异常（包括404），这会和你前面定义的@app.errorhandler(404)逻辑冲突，导致404的自定义处理可能被覆盖。

修复方法： #

把500错误的处理改成专门针对500状态码的装饰器：

@app.errorhandler(500)
def internal_error(error):
    return render_template('500.html'), 500

3. 验证base.html的存在性与路径 #

你的404.html继承了base.html，如果base.html不在templates文件夹里，或者文件名拼写错误（比如大小写不匹配），模板渲染会直接失败，最终返回空白页面。

检查点： #

• 确认base.html确实在templates文件夹内
• 检查404.html里的{% extends "base.html" %}路径是否正确（如果base在子文件夹里，要写相对路径，比如{% extends "layouts/base.html" %}）

额外验证步骤：手动测试模板渲染 #

可以临时添加一个测试路由，手动渲染404.html，验证模板本身是否能正常显示：

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

访问http://127.0.0.1:5000/test-404如果能正常显示，说明模板路径和内容没问题，问题就只出在错误处理的配置上。

按上面的步骤调整后，再访问错误URL，应该就能看到自定义的404/500页面了。

内容的提问来源于stack exchange，提问作者Dev.D