Flask默认不触发@app.errorhandler(405)，因其在路由匹配失败时直接由Werkzeug返回内置405响应，未进入错误处理器链路；须改用app.register_error_handler(405, handler)并在所有路由注册后显式调用。
Flask 默认不触发 errorhandler(405) 的原因
直接注册 @app.errorhandler(405) 通常无效——这不是 bug，而是 Flask 的路由匹配逻辑决定的：当请求方法（如 POST）与路由定义的 methods 列表完全不匹配时，Flask 在进入视图函数前就已返回 405 响应，根本不会走到错误处理器链路。你看到的 405 页面是 Werkzeug 内置的默认响应，不是你的 errorhandler 输出的。
必须用 register_error_handler 绑定到 Blueprint 或应用实例
正确做法是绕过常规装饰器，显式调用 register_error_handler，并确保在所有路由注册之后执行。否则 handler 可能未被加载。
- 对全局应用：用
app.register_error_handler(405, your_handler) - 对蓝图：用
bp.register_error_handler(405, your_handler)，且该蓝图需已注册到 app - handler 函数必须返回
Response对象或可转为响应的值（如字符串、字典）
示例：
from flask import Flask, jsonify
<p>app = Flask(<strong>name</strong>)</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill8910" title="361SCAN security check your skill python scripts"><img
src="https://img.php.cn/upload/skill/000/000/081/179231049778675.jpg" alt="361SCAN security check your skill python scripts" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill8910" title="361SCAN security check your skill python scripts">361SCAN security check your skill python scripts</a>
<p>扫描并分析已安装技能，用于查看指定技能目录的名称、描述和详情，或列出所有已安装的技能。</p>
</div>
<a href="/xiazai/skill8910" title="361SCAN security check your skill python scripts" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>def handle_method_not_allowed(e):
return jsonify({"error": "Method not allowed", "status": 405}), 405</p><h1>注意：必须在所有 @app.route() 之后调用</h1><p>app.register_error_handler(405, handle_method_not_allowed)</p><p>@app.route('/api/data', methods=['GET'])
def get_data():
return {"data": "ok"}
为什么 @app.route 不写 methods 会导致 405 捕获失效
如果路由没声明 methods，Flask 默认只允许 GET。此时用 POST 访问该路由，会直接 405，但 handler 仍可能不生效——因为 Flask 在早期阶段就拒绝了请求，甚至没完成应用上下文初始化。这类“隐式 GET 路由”是 405 处理中最容易漏掉的场景。
- 显式声明
methods=['GET', 'POST']后，未匹配的方法才走标准 405 流程，register_error_handler才可靠 - 检查所有路由，避免依赖默认行为；工具如
app.url_map可打印当前路由表验证 - 测试时用
curl -X POST http://localhost:5000/your-route，别只靠浏览器刷新（默认 GET）
调试时看不到自定义 405 响应？检查 WSGI 中间件和开发服务器
某些 WSGI 中间件（如 ProxyFix、HTTPMethodOverride）或生产服务器（Gunicorn/Uvicorn）可能提前拦截或重写状态码。开发时用 Flask 自带服务器，但也要确认没有启用 debug=True 下的自动重定向（比如访问 /path/ 时 301 跳转到 /path，再触发 405）。
- 临时关闭所有中间件，用
flask run --debug=False验证基础行为 - 在 handler 函数里加
print("405 caught")，确认是否真被调用 - 注意：
abort(405)是主动抛出，它会走errorhandler；而路由不匹配是被动响应，路径不同
实际部署中，最常被忽略的是路由定义顺序和 register_error_handler 的调用时机——handler 必须在所有 route 之后注册，且不能放在条件分支里（比如 if DEBUG: 块内），否则上线后静默失效。
