Kubernetes终止Pod时pyodbc查询被中断，如何保障查询正常完成？

场景与目标 #

• 在Kubernetes环境中运行Python Docker容器，业务逻辑为：接收消息后通过pyodbc执行长时间运行的SQL Server语句
• 核心目标：通过延长Kubernetes超时时间、拦截关闭信号，确保Pod被终止前能完成当前正在执行的SQL查询

已实施的配置 #

Kubernetes配置 #

在k8s.yaml中设置终止宽限期，预留足够的执行时间：

terminationGracePeriodSeconds: 1800

Python信号处理代码 #

实现信号处理函数，触发后通过threading.Event通知主循环优雅终止：

def graceful_shutdown(_signo, _stack_frame):
    _logger.info(
        f"Received {_signo}, attempting to let the queries finish gracefully before shutting down."
    )
    # shutdown_event 为 threading.Event 实例
    shutdown_event.set()

在主执行循环中注册信号监听：

signal.signal(signal.SIGTERM, graceful_shutdown)
signal.signal(signal.SIGINT, graceful_shutdown)
signal.signal(signal.SIGHUP, graceful_shutdown)

问题现象 #

• 容器空闲时：能正常收到SIGHUP信号，graceful_shutdown触发后，shutdown_event可通知主循环正常终止，流程无异常
• SQL查询执行中：graceful_shutdown完全不被调用，pyodbc直接抛出连接错误：

pyodbc.OperationalError: ('08S01', '[08S01] [Microsoft][ODBC Driver 17 for SQL Server]TCP Provider: Error code 0x2714 (10004) (SQLExecDirectW)')

• 错误根源：Kubernetes终止Pod时直接切断了Python容器与SQL Server的通信链路

疑问 #

是否有办法阻止该错误抛出，让pyodbc完成当前正在运行的SQL查询？

内容的提问来源于stack exchange，提问作者Max