Flask应用需在主线程注册SIGTERM/SIGINT信号处理器，通过engine.dispose()释放SQLAlchemy连接池，再调用sys.exit(0)或os._exit(0)终止进程；避免使用current_app等上下文变量，且容器环境下应优先采用进程管理器提供的钩子而非依赖atexit。
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">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9386" title="python学习"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20e695c2374.jpg" alt="python学习" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9386" title="python学习">python学习</a>
<p>Python 编程学习助手 skill，面向零基础用户。 当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill</p>
</div>
<a href="/xiazai/skill9386" title="python学习" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><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()
注意：如果用 create_engine(..., pool_pre_ping=True)，dispose() 仍有效；但若启用了 pool_recycle，信号处理前连接可能已被自动回收，不影响安全性。
为什么用 threading.Event 配合 signal 更稳妥？
当 Flask 运行在调试模式（debug=True）或使用 reloader 时，主进程会 fork 子进程，signal 注册可能失效或重复触发。此时用 threading.Event 把“退出信号”转为轮询标志，更可控。
- 主线程注册 signal，仅设置
exit_event.set() - 在
app.run()后加一个循环，检查exit_event.is_set()，然后手动调用清理逻辑 - Flask 本身不支持传入自定义事件，所以需绕过
run()，改用make_server().serve_forever()并捕获中断 - 这种模式适合容器环境（如 Kubernetes），其中 SIGTERM 发送后有固定宽限期，需精确控制退出时机
信号不是万能的，尤其在容器或进程管理器（supervisord、systemd）下，真正关键的是：谁发信号、谁收信号、谁负责清理。别把数据库关闭逻辑藏在请求中间件或 teardown 函数里——那些只对 HTTP 请求生效，对进程终止完全无效。
