根本原因是url_prefix被重复拼接或路径不连续，导致注册路径与请求路径不匹配而404；子蓝图url_prefix应写相对路径如/v1/users而非/api/v1/users，且所有前缀须以/开头、不以/结尾。
多级蓝图嵌套时 URL 前缀报错，根本原因不是 Flask 不支持嵌套，而是 url_prefix 被重复拼接或路径不连续——最终导致路由注册路径与请求路径不匹配，404 就是必然结果。
子蓝图注册时误带完整路径（如 /api/v1/users）
这是最常踩的坑：父蓝图已设 url_prefix='/api'，子蓝图又写 url_prefix='/api/v1/users'，注册后变成 /api/api/v1/users。
- Flask 会原样拼接父级前缀 + 子蓝图
url_prefix字符串，不做去重或解析 - 子蓝图的
url_prefix应只写相对路径，比如/v1/users，而不是带根或重复父级 - 若子蓝图需独立部署，可抽离为顶层蓝图，避免嵌套；否则必须保证其前缀“可叠加”
父蓝图未显式调用 register_blueprint() 注册子蓝图
蓝图对象本身不自动挂载路由，admin_bp.register_blueprint(user_bp) 这一步漏掉，子蓝图的路由就完全不会进入应用路由表。
- 即使子蓝图定义了
@user_bp.route('/profile')，没被注册就等于不存在 - 嵌套注册必须逐层显式调用：
app.register_blueprint()→parent_bp.register_blueprint()→child_bp.register_blueprint() - 检查
app.url_map或运行flask routes命令，确认目标路径是否真实出现在列表中
url_prefix 开头带斜杠但结尾也带斜杠（如 '/admin/'）
斜杠重复会导致中间出现 //，Werkzeug 路由匹配器默认不处理双斜杠，直接跳过匹配，返回 404。
立即学习“Python免费学习笔记（深入）”；
- 所有
url_prefix必须以/开头、且**不能以/结尾**（例如用'/admin'，不用'/admin/'） - 视图函数里的
@bp.route('/profile')同理：开头斜杠必须有，结尾斜杠不要加（除非你明确设置了strict_slashes=False） - 路径拼接逻辑是字符串连接：
'/admin' + '/profile'→'/admin/profile'，而'/admin/' + '/profile'→'/admin//profile'
注册顺序与路由冲突导致后注册蓝图失效
Flask 按注册顺序匹配路由，一旦某条规则命中，就不会继续往后找。如果两个蓝图注册了重叠前缀（比如都用了 /api），先注册的会吞掉后注册的全部路径。
- 执行
flask routes查看实际注册顺序和完整路径，确认是否存在覆盖 - 避免在不同层级对同一段路径做多次声明，例如父蓝图用
/api，子蓝图又注册一个同名api_v2_bp到同一父级 - 调试时可临时把子蓝图提到顶层注册，验证是否是嵌套逻辑问题而非路由内容问题
真正容易被忽略的是：嵌套蓝图的 url_prefix 不是“继承”，而是“拼接”；它不理解语义，只做字符串操作。哪怕你写了 url_prefix='/v1'，只要父级是 '/api'，最终就是 '/api/v1'——中间没有智能校验，也没有路径规范化。所以每层的前缀值，必须从设计阶段就约定好“谁负责哪一段”。
