500错误是werkzeug对未捕获异常的兜底响应，根本原因是视图函数抛出异常且未被try/except拦截；debug=true无效主因是启动方式错误——app.run(debug=true)仅在直接运行脚本时生效，flask run、gunicorn等部署方式会忽略，应改用flask --app app.py --debug run或flask_debug=1环境变量。
500 Internal Server Error 不是 Flask 特有的错误，而是 Werkzeug 在视图函数抛出未捕获异常时返回的兜底响应。你看到白页或 “Internal Server Error”，说明代码某处崩了，但没被 try/except 拦住，也没被日志记录下来。
debug=True 为什么没用？启动方式错了
常见现象：加了 app.run(debug=True)，改代码不热重载，500 错误仍只显示白页、无堆栈。根本原因是 app.run() 只在直接运行脚本（python app.py）时生效；用 flask run、gunicorn、uWSGI 或宝塔部署时，这个参数完全被忽略。
- 开发阶段统一用命令行启动：
flask --app app.py --debug run（注意--debug是独立 flag，不是--debug=True） - 更可靠的方式是设环境变量：
FLASK_DEBUG=1 flask --app app.py run - 检查是否误把
app.run()放在if __name__ == '__main__':外面——那样 debug 参数根本不会执行 - 生产环境严禁开启 debug，它会暴露源码路径、变量值，甚至允许远程代码执行
日志里看不到 traceback？stderr 被吞了
Flask 默认只把错误发给 stderr，但容器、systemd、nohup 或宝塔面板常会截断或忽略它，导致你既没终端输出，也没文件日志。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 手动加文件日志处理器：
app.logger.addHandler(logging.FileHandler('flask_error.log'))，并确保级别设为ERROR - 检查是否调用了
app.logger.setLevel(logging.WARNING)——这会过滤掉ERROR级日志 - 用 gunicorn 启动时，必须加
--log-level debug --capture-output，否则 worker 进程的 stderr 不透出 - 宝塔用户直接看
/www/wwwlogs/your_project.error.log，别只盯 access.log
常见崩溃点：JSON 序列化、数据库查询、模型预测
这些操作看似“应该能过”，但一碰到空值、非法输入或配置缺失，就会直接抛异常，触发 500。
-
jsonify(model_instance)崩溃？SQLAlchemy 模型不能直接 JSON 序列化 → 改用model.to_dict()或json.dumps(obj, default=str) -
session.query(User).one()找不到记录？抛NoResultFound→ 改用.one_or_none()+ 判空，或包try/except NoResultFound -
feature_extraction.transform([text])报ValueError: empty vocabulary？输入为空或全是停用词 → 先校验if not text.strip(): return jsonify({'error': 'empty input'}), 400 -
mail.send(msg)报ConnectionRefusedError？Mail(app)初始化太早，app.config还没写入 SMTP 参数 → 必须先配全MAIL_SERVER等，再初始化mail = Mail(app)
POST 请求没返回值也报 500？Flask 路由强制要求返回响应
视图函数所有执行路径都必须有返回值，哪怕只是 return '', 204。漏写 return、或只在 if request.method == 'POST' 里返回，GET 分支没返回，就必然触发 TypeError: The view function did not return a valid response，最终变成 500。
- 检查每个
if/elif/else分支、每个try/except分支，是否都含return - 避免在函数末尾隐式返回
None，尤其在有早期return的逻辑里 - Chrome 插件调用时还要注意 CORS：若
CORS(app)没配origins或methods，预检请求（OPTIONS）失败也可能间接导致 500（尤其 debug=True 时）
最易被忽略的是：异常发生在扩展初始化阶段（比如 db.init_app(app) 漏掉），导致后续 db.session 是 None，再调 .query 就报 'NoneType' object is not callable ——这种错不在路由里，而在模块顶层，必须从 import 链和初始化顺序查起。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
