最常见的原因是注册时机错误：必须在app实例创建后、app.run()前注册，且蓝图中需用@bp.app_errorhandler(404)而非@bp.errorhandler(404)才能捕获全局404。
为什么 errorhandler 不生效？
最常见的原因是装饰器注册位置不对：Flask 的 @app.errorhandler(404) 必须在 app 实例创建之后、app.run() 之前注册，且不能放在蓝图（Blueprint）内部却期望捕获全局请求错误。如果你用的是蓝图，得用 @bp.app_errorhandler(404)，否则 404 仍会回退到默认响应。
实操建议：
立即学习“Python免费学习笔记（深入）”；
火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要
- 把所有
@app.errorhandler放在创建app后、app.register_blueprint()之后的统一位置（比如errors.py中集中定义，再导入调用） - 调试时临时加一行
print("404 handler triggered")，确认是否真被调用 - 注意开发模式下
debug=True会屏蔽 500 页面，改用debug=False测试真实错误页
如何让 404 和 500 页面渲染模板并保留状态？
直接 return render_template("404.html") 没问题，但容易漏掉两个关键点：HTTP 状态码没显式设置、模板里拿不到原始请求上下文（比如想显示当前 URL 或 referrer）。Flask 默认返回 200 状态，搜索引擎会当正常页面收录。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 必须显式传入
status参数：return render_template("404.html"), 404 - 若需传递额外信息，用
request对象：render_template("500.html", url=request.url, referrer=request.headers.get("Referer")) - 避免在错误处理函数里再抛异常（比如模板渲染失败），否则会触发循环错误页或 WSGI 层默认响应
自定义异常类 + abort() 怎么和 errorhandler 配合？
硬写 abort(403) 不够语义化，尤其业务逻辑中需要区分“权限不足”和“资源已删除”。这时应定义继承 HTTPException 的异常类，并用 @app.errorhandler 绑定它。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 定义异常类时指定
code和description：class InsufficientPermission(HTTPException): code = 403 description = "You don't have permission to access this resource." - 抛出时直接
raise InsufficientPermission()，无需abort() - 注册处理器用类名：
@app.errorhandler(InsufficientPermission)，不是字符串 - 注意：这类异常不会被
@app.errorhandler(403)捕获，除非你额外注册一个兜底的 403 处理器
静态文件 404 能否走自定义页面？
不能。Flask 的静态视图（/static/xxx）由内置的 send_static_file 处理，它在抛出 404 前就终止了请求生命周期，不经过 errorhandler 链。用户访问 /static/nonexist.js 仍看到默认 404 文本。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 生产环境务必用 Nginx / Apache 托管静态文件，它们可配置自定义 error_page
- 开发时若坚持拦截，可重写
app.static_folder为自定义视图，但性能差且易出错，不推荐 - 更实际的做法：在构建流程中校验静态引用完整性（如用
htmlproofer），从源头减少 404
@app.errorhandler。 
