AWS Lambda连接RDS PostgreSQL触发Task timed out超时错误如何修复

核心原因定位 #

超时90%以上概率是网络连通性问题，psycopg2默认无连接超时限制，会持续等待连接直到Lambda函数被强制终止，因此没有抛出具体错误日志。

分步排查点 #

• 1. Lambda与RDS网络配置校验 #

  • 若RDS部署在私有VPC内，需将Lambda函数也部署到同一VPC下的相同可用区子网，并给Lambda配置VPC执行权限（绑定AWSLambdaVPCAccessExecutionRole角色）
  • 安全组规则校验：RDS实例的入站安全组需开放5432端口，允许Lambda所属安全组的访问请求；Lambda的出站安全组需开放5432端口到RDS的访问权限
  • 若RDS开启了公网访问，Lambda若部署在VPC内需绑定NAT网关/弹性公网IP，否则无法访问公网资源

• 2. Lambda基础配置调整 #

  默认Lambda函数执行超时为3秒，先将超时时间调整为10~15秒，排除执行时间不足的问题

• 3. 代码逻辑优化 #

  当前代码异常捕获逻辑过于粗糙，且未配置数据库连接超时，无法定位具体错误，需做如下修改：

  修改后的db_util.py代码

  import psycopg2
  import traceback
  
  db_host = "你的实际RDS访问域名"
  db_port = 5432
  db_name = "实际数据库名称"
  db_user = "实际数据库用户名"
  db_pass = "实际数据库密码"
  db_table = "实际表名"
  
  def make_conn():
      conn = None
      try:
          # 新增connect_timeout参数，超过5秒未连接成功直接抛出异常
          conn = psycopg2.connect(
              dbname=db_name,
              user=db_user,
              host=db_host,
              password=db_pass,
              port=db_port,
              connect_timeout=5
          )
      except Exception as e:
          print("连接数据库失败，错误信息：", str(e))
          print(traceback.format_exc())
          # 连接失败直接抛出异常，避免后续空指针报错
          raise e
      return conn
  
  def fetch_data(conn, query):
      result = []
      print("Now executing: " + query)
      cursor = conn.cursor()
      cursor.execute(query)
      raw = cursor.fetchall()
      for line in raw:
          result.append(line)
      return result
  

• 4. 辅助排查 #

  修改后重新执行函数，若仍然报错可从返回的具体错误信息判断：如果是权限/凭证错误会直接返回对应提示，如果还是超时则回到网络配置环节重新核对安全组、路由表、VPC配置。

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