### Flask 在 Debug 模式下运行两次的原因及解决方案 #### 原因分析 当 Flask 应用处于调试 (`debug`) 模式时，它会启用 Werkzeug 的重载器 (reloader)，这是一个后台监控机制。这个机制会在检测到代码发生变化时自动重启应用[^2]。为了实现这一功能，Flask 会在父进程中启动一个子进程来运行实际的应用实例。这种架构设计导致了某些情况下（例如使用 `flask-apscheduler` 定时任务或其他全局初始化逻辑）可能会被重复执行一次。 具体而言，每次启动 Flask 应用时： 1. 父进程负责监听文件变化并决定是否需要重启。 2. 子进程承载实际的 HTTP 请求处理逻辑。 由于调度器或类似的组件通常是在应用初始化阶段注册的，它们会被两个进程分别加载和执行一遍，从而造成任务重复运行的现象[^4]。 --- #### 解决方案 ##### 方法一：禁用重载器 可以通过显式设置参数 `use_reloader=False` 来关闭 Werkzeug 的重载功能。这样可以确保只有一个进程运行整个应用程序，避免任何可能的重复行为。 ```python if __name__ == '__main__': app.run(debug=True, use_reloader=False) ``` 这种方式简单有效，但缺点是失去了热更新的能力，即在开发过程中修改代码后不会自动刷新页面[^2]。 --- ##### 方法二：仅在主进程中初始化定时任务 另一种更灵活的办法是对当前进程的角色加以区分，只让真正的工作进程（通常是子进程）承担起始化职责。这可通过检查环境变量 `_WERKZEUG_RUN_MAIN` 实现： ```python from flask import Flask from flask_apscheduler import APScheduler app = Flask(__name__) scheduler = APScheduler() @app.route('/') def index(): return "Hello World!" if __name__ == '__main__': if not app.debug or os.environ.get('_WERKZEUG_RUN_MAIN') == 'true': scheduler.init_app(app) scheduler.start() app.run(debug=True) ``` 在此配置下，只有当 `_WERKZEUG_RUN_MAIN` 设置为 `'true'` 时才会激活 APScheduler，这意味着定时任务只会由最终的服务端口绑定的那个子进程接管[^4]。 --- ##### 方法三：完全关闭调试模式 如果不需要实时查看改动效果，可以直接将 `debug` 参数设为 `False`。这是最彻底但也相对不友好的办法，因为它剥夺了开发者享受便捷调试体验的权利。 ```python if __name__ == '__main__': app.run(debug=False) ``` 注意，生产环境下始终建议关闭调试选项以提高安全性与稳定性。 --- ### 总结说明 以上三种策略各有优劣，可以根据实际需求选取最适合的一种实施下去。一般推荐采用第二种做法，既保留了动态调整的优势又能妥善规避多实例引发的问题。 ---