最常见的原因是app.register_blueprint()被放在视图函数定义之前或if name == "__main__":块里，导致仅直接运行时注册，而flask run或工厂函数启动时不执行；必须确保在应用实例创建后、服务器启动前统一注册。
蓝图注册语句写在了错误位置
最常见的原因是 app.register_blueprint() 被放在了视图函数定义之前，或者放在了 if __name__ == "__main__": 块里——这意味着只有直接运行该文件时才注册，而用 flask run 或工厂函数启动时完全不执行。
必须确保注册发生在 Flask 应用实例创建之后、服务器启动之前，且对所有启动方式都生效。例如在工厂函数中：
def create_app():
app = Flask(__name__)
# ✅ 正确：注册放在这里
from .blueprints.auth import auth_bp
app.register_blueprint(auth_bp, url_prefix='/auth')
return app
- 不要把注册逻辑塞进
main.py的if __name__ == "__main__"里 - 不要在蓝图模块内部调用
register_blueprint()（会形成循环导入） - 若用
flask run，确保FLASK_APP指向的是调用了create_app并完成注册的文件
蓝图未被 import 触发加载
Flask 不会自动扫描和导入蓝图模块。即使你写了 @auth_bp.route('/login')，如果没人 import 这个模块，装饰器根本不会执行，路由也就不会绑定到蓝图对象上。
典型错误是只写了蓝图定义，但主应用里漏掉了 from .blueprints.auth import auth_bp 这一行。
- 检查 import 语句是否拼写正确，路径是否相对于当前文件（比如
app.py所在目录） - 确认 import 发生在
register_blueprint()之前 - 可以在 import 后加一句
print(auth_bp.name)验证模块是否真被加载
url_prefix 或路由路径拼写不一致
访问 /login 返回 404，但蓝图里写的是 @auth_bp.route('/login')，并不意味着路径就对了——还要看注册时有没有加 url_prefix。
比如 app.register_blueprint(auth_bp, url_prefix='/auth')，那真实路径就是 /auth/login，不是 /login。
- 检查
url_prefix是否为空字符串、斜杠结尾与否（'/auth'和'/auth/'行为不同） - 确认浏览器请求的 URL 完全匹配组合后的路径（注意大小写、多余斜杠、查询参数不影响匹配）
- 可以用
app.url_map在 shell 中打印所有已注册路由：print(list(app.url_map.iter_rules()))
调试时旧进程还在监听端口
VS Code 终端里改完蓝图代码，点了「重新运行」却仍返回旧响应？大概率是上一个 flask run 或 python app.py 进程没真正退出，新代码压根没跑起来。
Werkzeug 的重载器（Restarting with stat）只对当前进程有效，它不会杀掉旧进程。
- 每次修改后，先按
Ctrl+C确保终端显示KeyboardInterrupt或Shutting down - 别依赖浏览器刷新或缓存；关掉所有终端标签页再新开一个
- 如果用 VS Code 调试，确认「停止调试」按钮已点击，而非仅关闭终端窗口
蓝图本身不保存路由，它只是容器；路由是否生效，取决于“谁定义了它”“谁 import 了它”“谁把它挂到了 app 上”“挂的时候有没有被旧进程覆盖”。这四个环节缺一不可，任意一个断开都会导致 404。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
