本地测试AWS Lambda函数时遇300秒容器超时问题求助

• 检查Lambda Runtime Emulator默认超时
  本地运行Lambda容器时，默认的Runtime Emulator自带300秒（5分钟）超时限制，哪怕生产环境设了15分钟，本地没显式配置的话就会沿用默认值。启动容器时添加环境变量覆盖：

  docker run -e AWS_LAMBDA_FUNCTION_TIMEOUT=900 -p 9000:8080 your-lambda-image:latest
  

  900对应15分钟，和生产环境保持一致即可。

• 排查Dockerfile中的运行时配置
  如果你用的是AWS官方基础镜像（比如public.ecr.aws/lambda/python:3.12），检查Dockerfile里的CMD/ENTRYPOINT有没有传递超时参数，或是自定义启动脚本是否硬编码了超时时间。有相关设置的话直接调整数值。

• 验证boto3客户端的超时设置
  虽然你排查过访问密钥，但boto3部分客户端默认超时可能偏短，比如连接或读取超时，会导致流程提前触发失败。初始化客户端时显式设置长超时：

  import boto3
  client = boto3.client('s3', config=boto3.client.Config(
      connect_timeout=900,
      read_timeout=900
  ))
  

  所有用到的boto3客户端都要同步设置对应超时。

• 检查本地容器的资源限制
  本地Docker容器内存、CPU资源不足时，函数执行会变慢，间接触发超时。用docker stats查看容器资源占用情况，不够的话调整分配：

  docker run --memory 2048m --cpus 2 -e AWS_LAMBDA_FUNCTION_TIMEOUT=900 -p 9000:8080 your-lambda-image:latest
  

  这里分配了2GB内存和2核CPU，可根据实际需求修改。

• 查看容器实时日志
  运行容器时用docker logs -f <container-id>跟踪日志，确认超时是Runtime Emulator强制终止导致，还是函数内部逻辑问题。如果日志出现Task timed out after 300.00 seconds，就是模拟器的默认限制问题；否则需要排查函数代码中的耗时逻辑。

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