Python应用连接AWS RDS MySQL闲置后报错排查求助

现象 #

应用启动时首次查询AWS RDS上的MySQL 8.0.28数据库正常，但闲置2-3分钟后再次查询，出现Lost connection to MySQL server during query ([Errno 54] Connection reset by peer)错误。

一、排查数据库主机端（AWS RDS） #

• 检查MySQL超时参数：登录RDS执行SHOW VARIABLES LIKE '%timeout';，重点看wait_timeout和interactive_timeout的值。如果这两个参数被设置为120-180秒（2-3分钟），说明是数据库主动断开了闲置连接，这是问题根源。RDS默认值通常是28800秒（8小时），但可能被自定义配置修改。
• 检查网络层配置：查看AWS安全组、网络访问控制列表（NACLs）是否有闲置连接超时规则；同时排查VPC内的防火墙、负载均衡等设备，是否存在短时间切断闲置连接的设置。
• 查看CloudWatch指标：在AWS控制台查看RDS的DatabaseConnections（连接数变化）、ClientErrors（客户端错误数）等指标，判断是否有连接被主动回收的迹象；同时检查NetworkTransmitThroughput等网络指标，排除网络故障。

二、排查应用端（Python + SQLAlchemy + pymysql） #

• 配置连接池自动回收：SQLAlchemy默认连接池（QueuePool）不会主动回收闲置连接，如果数据库断开了连接，应用复用失效连接就会报错。修改engine创建代码，添加pool_recycle参数，设置为比数据库wait_timeout小30秒左右的值（比如180秒）：

engine = create_engine(
    "mysql+pymysql://{}:{}@{}/{}".format(user,pwd,host,database),
    pool_recycle=180  # 主动回收3分钟以上的闲置连接
)

• 优化连接使用方式：避免手动connect()和close()，改用上下文管理器自动管理连接，确保连接正确归还到池，且失效时自动重试：

with engine.connect() as con:
    df = pd.read_sql(query, con)

• 升级pymysql版本：旧版本pymysql可能存在连接失效处理的bug，执行pip install --upgrade pymysql升级到最新稳定版。

三、验证步骤 #

1. 先确认数据库的wait_timeout值，如果是2-3分钟，说明问题在数据库端的超时配置，应用端需配合调整连接池参数。
2. 若数据库超时为默认8小时，清空连接池后重试：执行engine.dispose()，再发起查询，如果成功，说明是应用端连接池保留失效连接导致的问题。
3. 临时测试：在闲置后直接创建新的engine（而不是复用旧的），如果查询正常，进一步确认是连接池配置问题。

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