@app.route必须紧贴视图函数上方且app实例已创建；路径参数需严格匹配类型与顺序；多路由冲突时应将更具体的路由写在前面；调试时优先检查app.url_map。
Flask @app.route 装饰器怎么写才不 404？
路由没生效，八成是装饰器没挂对位置或没加 app 实例引用。最常见的是把 @app.route 写在函数定义之外、缩进错位，或者函数没定义在 app 创建之后。
-
@app.route必须紧贴在视图函数上方，且该函数必须已定义（不能在if块里动态定义） - 确保
app = Flask(__name__)在所有@app.route之前执行，否则会报NameError: name 'app' is not defined - 如果用蓝本（Blueprint），得用
@bp.route，而不是@app.route，混用会导致路由注册失败 - 路径开头不加
/会被 Flask 自动补上；但结尾加不加/会影响匹配逻辑：带尾斜杠的路由默认接受带/和不带/的请求（重定向一次），不带尾斜杠则严格匹配
URL 里的变量怎么取？<uid></uid> 和 <name></name> 有啥区别？
Flask 默认只识别 <variable></variable> 这种无类型写法，它等价于 <variable></variable> —— 所有参数都当字符串传进来，哪怕 URL 里写的是 /user/123，uid 的值也是字符串 "123"。
-
<uid></uid>会自动做类型转换：匹配数字字符串，并转成int类型；若 URL 是/user/abc，直接返回 404，不会进视图函数 -
<price></price>同理，只接受带小数点的数字，/item/99会 404，/item/99.0才行 -
<subpath></subpath>可捕获含斜杠的路径段，比如/static/<filename></filename>能匹配/static/css/app.css；普通<string></string>遇到/就截断 - 自定义转换器要继承
BaseConverter并注册到app.url_map.converters，不是光写个类就生效
多个参数怎么传？顺序、可选性、默认值怎么控制？
URL 参数顺序必须和函数参数顺序一致，Flask 不按名字绑定，只按位置传参。比如 @app.route('/<a>/<b>')</b></a> 对应 def calc(a, b):，不能写成 def calc(b, a):。
- 路径参数全为必填项，不支持“某个参数可选”；想实现可选，得拆成两个路由，或改用查询参数（
request.args.get('q')） - 函数参数可以设默认值，但前提是该参数**不是**路径变量——路径变量一定由 URL 提供，设默认值无效
- 如果既要路径参数又要查询参数，比如
/user/<uid>?format=json</uid>，Flask 会自动解析request.args，和路径装饰器无关 - 别在路径里塞太多参数，超过 3 个就该考虑用
POST + JSON或重构 URL 设计，否则难读、难测、难调试
为什么加了类型约束还是进不去函数？常见 404 原因
加了 <id></id> 却仍 404，大概率不是代码写错，而是请求方法不匹配或规则被覆盖。
立即学习“Python免费学习笔记（深入）”；
- 检查是否忘了声明
methods：默认只响应GET，如果用curl -X POST访问@app.route('/api')，就会 405（Method Not Allowed），不是 404；但若同时存在@app.route('/api', methods=['GET'])和@app.route('/api', methods=['POST'])，而你发的是PUT，那就是 405 - 多个路由规则冲突时，Flask 按注册顺序匹配，后注册的不会覆盖前面的；比如先注册
/user/<id></id>，再注册/user/new，那么访问/user/new会先进第一个路由（因为new不是 int，触发 404），必须把更具体的路由写在前面 - 开发时开了调试模式（
debug=True），但浏览器缓存了旧的 404 响应，试试加个随机查询参数或清缓存 - 用 WSGI 部署时，反向代理（如 Nginx）可能截断了路径或改写了
SCRIPT_NAME，导致 Flask 看不到完整 URL，这时要检查app.config['APPLICATION_ROOT']或代理配置
类型约束本身很轻量，但组合上路径顺序、请求方法、注册时机、部署环境，就很容易漏掉一环。实际调试时，先确认 app.url_map 里有没有你预期的规则（打印 app.url_map 或用 flask routes 命令），比盲改代码快得多。
