Flask 1.x 升级到 3.x 不可能“无缝”，必须修改代码：request.json需替换为request.get_json()，request.values被删除须拆分为form/args，JSON处理改用app.json.provider，strict_slashes默认启用且url_for报错更严格。
Flask 1.x 升级到 3.x 不可能“平滑”或“安全”地跳过代码修改——所有声称“无缝”的方案，都只适用于空项目或极简 demo。真实业务项目必须面对三类硬性断裂：API 废弃、Werkzeug 行为变更、JSON 处理逻辑重构。
request.json 访问直接返回 None 怎么办
这是最常踩的第一个坑：request.json 在 3.x 中不再自动解析请求体，访问即得 None，旧代码会静默失败。
- 必须全部替换为
request.get_json()，且注意它默认不校验Content-Type - 若需严格要求 JSON 请求，手动加检查：
if not request.is_json: abort(400) - 依赖
flask.json.jsonify的写法（如from flask.json import jsonify）已失效，改用from flask import jsonify - 自定义 JSON 编码器不能继续塞给
flask.json.JSONEncoder，要注册到app.json.provider（Flask 2.2+ 引入）
request.values 被删了，form/args 混用逻辑怎么拆
request.values 在 3.x 彻底移除，而它的行为本就模糊（优先 form，再 fallback args），旧代码靠它“偷懒”混用参数，现在必须显式区分。
- 所有
request.values.get("key")必须明确改为request.form.get("key")或request.args.get("key") -
request.files.getlist("name")仍可用，但list(request.files)遍历 key 的行为虽保留，多值上传场景下建议统一用getlist()避免歧义 - 若用
request.values.items(multi=True)，需重写为分别调用request.form.items(multi=True)和request.args.items(multi=True)并合并
路由注册和 url_for 报错更硬，endpoint 冲突怎么提前发现
3.x 默认启用 strict_slashes=True，且 url_for 对未注册 endpoint 的报错时机提前、不 fallback，导致模板里一个错写的 url_for("missing") 直接 500。
-
app.add_url_rule若没传endpoint参数，会自动生成，但多个蓝图注册同名视图函数时极易冲突——务必显式指定endpoint - 检查所有
url_for调用，确认对应@app.route或add_url_rule确实注册了该 endpoint；可临时加日志遍历app.view_functions.keys() - 测试阶段打开
app.config["DEBUG"] = True，能更快暴露未注册的 endpoint 引用
为什么 hasattr() 比版本判断更适合做兼容层
升级过程常需临时兼容新旧行为（比如插件要同时支持 1.x 和 3.x），但硬写 if flask.__version__ >= "3.0" 容易漏掉中间版本或被语义化版本号规则反噬。
立即学习“Python免费学习笔记（深入）”；
- 用
hasattr(request, "get_json")直接检测能力是否存在，比查版本更可靠 - 对上下文对象，
hasattr(current_app, "json_provider")可判断是否支持新 JSON 接口 - 这种模式在 Flask 扩展开发中已被广泛验证，比版本字符串解析更健壮，也更容易单元测试
request.values 模糊语义、靠 request.json 自动触发解析、或在蓝图间靠 endpoint 名字碰撞侥幸运行的逻辑——这些不会报错，但会在某个请求路径上悄悄返回错数据。上线前必须用真实流量回放或构造边界 case 测试表单提交、JSON POST、带查询参数的 GET 等组合场景。 
