blueprint的url_prefix必须在register_blueprint时显式传入，非构造参数；需注意结尾斜杠、不可复用同一实例、不支持嵌套自动继承前缀。
Blueprint注册时的url_prefix参数必须显式传入
Flask中Blueprint本身不自带路径前缀，url_prefix不是Blueprint构造函数的参数，而是调用app.register_blueprint()时才生效的选项。漏掉这一步，所有路由都会落在根路径下，和预期的多级结构完全脱节。
常见错误是以为在Blueprint(__name__, 'admin')里写个名字就能自动带/admin前缀——其实名字只用于内部标识，和URL无关。
-
admin_bp = Blueprint('admin', __name__)→ 此时无任何路径绑定 -
app.register_blueprint(admin_bp, url_prefix='/admin')→ 才真正挂载到/admin - 若需多级（如
/api/v2/users），url_prefix必须写全：url_prefix='/api/v2/users'
嵌套Blueprint需逐层注册，不能靠子Blueprint自动继承父前缀
Flask原生不支持“父Blueprint给子Blueprint自动加前缀”。比如你有api_bp和它里面的users_bp，想让users路由变成/api/v1/users/xxx，不能只给api_bp设url_prefix='/api/v1'就完事——users_bp仍需单独注册，并手动拼好完整前缀。
否则users_bp里的@users_bp.route('/list')会落到/list，而非/api/v1/users/list。
- 正确做法：先注册
api_bp到/api/v1，再注册users_bp到/api/v1/users - 避免把
users_bp注册到api_bp对象上（Flask不支持api_bp.register_blueprint(...)） - 若路由层级深、重复多，建议用变量拼接前缀，例如
API_V1_PREFIX = '/api/v1'，再传url_prefix=f'{API_V1_PREFIX}/users'
同一Blueprint多次注册不同url_prefix会导致路由冲突
一个Blueprint实例只能注册一次。如果误写两次app.register_blueprint(bp, url_prefix='/v1')和app.register_blueprint(bp, url_prefix='/v2')，Flask启动时不会报错，但所有/v2下的路由实际会响应/v1的请求——因为第二次注册覆盖了第一次的endpoint映射，且Flask内部用blueprint name + endpoint name做唯一键，前缀变更不触发重新校验。
现象是：访问/v2/xxx返回404，而/v1/xxx能正常工作，但日志里可能显示两个路由都注册成功了。
- 解决办法：每个需要不同前缀的场景，都新建独立的Blueprint实例，哪怕逻辑完全一样
- 例如版本隔离：
v1_users_bp = Blueprint('users_v1', __name__)、v2_users_bp = Blueprint('users_v2', __name__) - 别图省事复用同一个bp对象，这是静默陷阱
url_prefix结尾斜杠影响路由匹配行为
url_prefix='/admin'和url_prefix='/admin/'在Flask中行为不同：前者会使@bp.route('/dashboard')最终变成/admindashboard（自动抹掉中间斜杠），后者才会正确生成/admin/dashboard。
根本原因是Flask对url_prefix和@route路径做字符串拼接，而不是路径解析。所以url_prefix末尾是否带/，直接决定拼接后有没有分隔符。
- 统一约定：所有
url_prefix都以/结尾，所有@route路径都以/开头（如@bp.route('/list')） - 例外情况：若
url_prefix为空字符串''，则@route('/list')就是/list；此时加不加开头/不影响，但为了一致性仍建议保留 - 调试技巧：启动后访问
/flask/routes（需开启debug）或打印app.url_map，确认实际注册的endpoint路径是否符合预期
url_prefix结尾斜杠和Blueprint复用这两点，线上出问题时往往卡在这儿。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
