Psycopg连接在进程异常退出时的清理机制

在使用Psycopg连接PostgreSQL数据库时，当Python进程被强制终止（如超时被gunicorn杀死），可能会出现数据库连接未正确关闭的情况。本文将深入探讨这一问题的成因及解决方案。

问题现象

在gunicorn等应用服务器环境中，当数据库查询执行时间超过worker超时设置时，worker进程会被强制终止。此时可能会出现以下情况：

1. 数据库连接未正确关闭
2. 长时间运行的查询仍在数据库服务器上执行
3. 随着新worker启动并执行新查询，可能导致服务器负载雪崩

问题根源分析

Psycopg的Connection对象在Python上下文管理器(with语句)退出时会自动调用rollback()进行清理。但在进程被强制终止的情况下：

1. rollback()无法执行，因为前一个查询仍在运行
2. 进程突然终止导致TCP连接中断，但PostgreSQL服务器端可能不会立即感知
3. 数据库服务器继续执行被中断的查询

解决方案

1. 使用cancel()主动取消查询

最可靠的解决方案是在信号处理器中调用conn.cancel()：

import signal
import psycopg

def signal_handler(signum, frame):
    conn.cancel()

signal.signal(signal.SIGTERM, signal_handler)

with psycopg.connect("...") as conn:
    # 执行查询

这种方法能确保：

• 立即向PostgreSQL服务器发送查询取消请求
• 服务器端会终止正在执行的查询
• 连接会被正确关闭

2. 设置statement_timeout作为安全网

除了程序层面的处理，还应该在数据库层面设置超时：

with psycopg.connect("...") as conn:
    with conn.transaction():
        conn.execute("set statement_timeout to '60s'")

这样即使程序意外终止，数据库也会在超时后自动终止查询。

其他尝试方法的分析

1. 直接终止进程：连接可能不会立即关闭
2. 在handler中调用conn.close()：无法终止正在运行的查询
3. 在handler中调用conn.rollback()：会阻塞，因为前一个查询仍在运行

最佳实践建议

1. 为长时间运行的查询设置合理的statement_timeout
2. 在信号处理器中实现cancel()调用
3. 监控数据库中的长时间运行查询
4. 考虑使用连接池管理连接生命周期

通过以上措施，可以确保即使在进程异常退出的情况下，数据库连接和查询也能被正确清理，避免资源泄漏和服务器负载问题。