AWS Lambda导入自定义Layer模块时意外超时问题求助

可能的原因及排查步骤 #

• 导入时触发阻塞性操作：
  你的functions.py里导入了pymysql、boto3，如果模块里存在顶层执行代码（比如在函数/类定义之外直接调用get_db_connection()、初始化加密类实例），这些代码会在导入时自动运行。如果涉及数据库连接、网络请求，而Lambda的VPC配置不当（比如子网没权限访问数据库、安全组端口未开放），就会卡住超时。
  排查方法：把functions.py里所有顶层的执行代码（非定义类/函数的代码）全部移到函数内部，只保留导入语句、类和函数定义。

• 拆分导入定位阻塞点：
  不要直接import helper，拆分导入步骤逐步测试，看卡在哪一步：

  def lambda_handler(event, context):
      import os
      print("开始测试导入")
      # 先导入functions模块
      from helper import functions
      print("已导入functions模块")
      # 逐个导入类和函数
      from helper.functions import InvalidInputException
      print("已导入异常类")
      from helper.functions import cors_response
      print("已导入响应函数")
      # ... 其他导入步骤
      # 后续原有代码
      layer_contents = os.listdir('/opt/python')
      helper_contents = os.listdir('/opt/python/helper')
      print(layer_contents)
      print(helper_contents)
      return {'statusCode':200, 'body':''}
  

  查看CloudWatch日志，看最后打印到哪一行，就能定位到卡住的导入环节。

• 检查依赖库的加载问题：
  确认你的Layer里是否包含pymysql（boto3是Lambda默认自带的）。如果Layer里没打包pymysql，导入helper时会触发依赖加载失败，但如果是pymysql版本与Lambda Python环境不兼容，可能导致导入时卡住。可以单独测试导入pymysql：

  def lambda_handler(event, context):
      import pymysql
      print("成功导入pymysql")
      # 再导入helper
      import helper
      # ... 其他代码
  

  如果导入pymysql就超时，重新打包兼容版本的pymysql到Layer中。

• 调整Lambda超时时间：
  默认Lambda超时是3秒，导入大模块或依赖时可能需要更长时间。临时把超时时间调到10秒，测试是否能完成导入，如果成功再根据实际情况调整。

额外注意点 #

• 确保functions.py里的类和函数定义语法正确，比如每个类/函数定义后要有缩进的代码块（哪怕是空的pass），语法错误可能导致导入异常（虽然通常是直接报错而非超时，但隐性语法问题也可能引发奇怪的阻塞）。示例修正：

  class InvalidInputException(Exception):
      pass  # 加上空实现避免语法错误
  
  def cors_response(_status_code:int, _response_body:dict) -> dict :
      pass  # 实际代码替换这里
  

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