怎样在Python Flask中捕获系统信号自动关闭数据库_使用signal模块-Python教程-PHP中文网

Flask应用需在主线程注册SIGTERM/SIGINT信号处理器，通过engine.dispose()释放SQLAlchemy连接池，再调用sys.exit(0)或os._exit(0)终止进程；避免使用current_app等上下文变量，且容器环境下应优先采用进程管理器提供的钩子而非依赖atexit。

怎样在python flask中捕获系统信号自动关闭数据库_使用signal模块

Flask 应用如何响应 SIGTERM / SIGINT 关闭数据库连接

Flask 本身不接管进程信号，signal 模块必须在主线程中提前注册，且需确保数据库连接（如 SQLAlchemy 的 engine 或原生 Connection）能被安全关闭。常见错误是信号处理函数里调用 Flask 上下文（如 current_app），这会失败——因为信号由 OS 直接触发，不经过 Flask 请求循环。

只在主模块（即运行 app.run() 的脚本）中注册信号，不要放在 Blueprint 或扩展初始化代码里
避免在信号处理器中访问 g、request、current_app 等上下文变量
使用全局变量或模块级对象保存数据库资源引用（如 db_engine），确保信号函数能直接访问
对 SQLAlchemy，优先调用 engine.dispose() 而非 engine.close()；前者清理连接池，后者只关闭当前连接

signal.signal() 注册后为什么 Flask 还没退出？

注册信号只是“监听”，不等于自动终止进程。你必须在信号处理器中显式调用 os._exit(0) 或触发 sys.exit()，但要注意：sys.exit() 会抛出 SystemExit 异常，在多线程环境下可能被忽略；而 os._exit() 是立即终止，不执行 atexit 回调或 finally 块——所以得先完成数据库清理，再调用它。

推荐顺序：清理数据库 → time.sleep(0.1)（让连接真正释放）→ os._exit(0)
不要依赖 atexit.register() 替代信号处理：它无法响应 kill -15 的优雅终止，只在 Python 正常退出时触发
若用 Gunicorn/uWSGI，信号由其主进程管理，你的 Flask 代码收不到 SIGTERM；此时应改用其提供的钩子（如 Gunicorn 的 on_exit）

SQLAlchemy + signal 结合的最小可靠示例

以下代码片段可直接运行，验证 Ctrl+C 或 kill -2 $PID 是否触发数据库关闭：

import signal
import sys
import time
from sqlalchemy import create_engine
<h1>全局 engine，供 signal handler 访问</h1><p>db_engine = create_engine('sqlite:///test.db')</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9386" title="python学习"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20e695c2374.jpg" alt="python学习" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill9386" title="python学习" class="overflowclass">python学习</a>
													<p class="overflowclass">Python 编程学习助手 skill，面向零基础用户。 当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill9386" title="python学习" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p>def shutdown_handler(signum, frame):
print(f"Received signal {signum}, closing DB...")
db_engine.dispose()  # 关键：释放连接池
time.sleep(0.1)
sys.exit(0)  # 或 os._exit(0)，取决于是否需要 atexit</p><p>signal.signal(signal.SIGINT, shutdown_handler)
signal.signal(signal.SIGTERM, shutdown_handler)</p><p>if <strong>name</strong> == '<strong>main</strong>':
from flask import Flask
app = Flask(<strong>name</strong>)
@app.route('/')
def hello():
return 'OK'
app.run()
</p>

注意：如果用 create_engine(..., pool_pre_ping=True)，dispose() 仍有效；但若启用了 pool_recycle，信号处理前连接可能已被自动回收，不影响安全性。