Lambda连接Amazon RDS Postgres报错缺少psycopg2._psycopg模块

调用对接Amazon RDS Postgres的Lambda函数时触发模块导入错误，报错信息如下：

{
  "errorMessage": "Unable to import module 'lambda_function': No module named'psycopg2._psycopg'",
  "errorType": "Runtime.ImportModuleError",
  "requestId": "c1c7e814-9560-4d5e-a71d-fa39fc33132e",
  "stackTrace": []
}

部署依赖包中已添加psycopg2-binary包，仍抛出上述异常。

psycopg2._psycopg是psycopg2的C语言扩展二进制模块，报错核心原因是上传的依赖包和Lambda运行环境不兼容：

• Lambda运行时基于Amazon Linux 2（对应Python 3.7~3.10版本）或Amazon Linux 2023（对应Python 3.11+版本），和本地Windows、macOS、其他Linux发行版的系统底层依赖、CPU架构存在差异
• 直接在本地环境执行pip安装得到的psycopg2-binary是适配本地环境的二进制文件，上传到Lambda后无法被Linux运行时加载，最终抛出模块找不到的错误

• 确认Lambda运行环境参数
  先在Lambda控制台确认函数的Python大版本、CPU架构（x86_64/arm64 Graviton2），后续安装依赖必须完全匹配这两个参数。
• 清理旧的冲突依赖
  删除本地打包目录内所有残留的psycopg2、psycopg2-binary相关文件夹、dist-info描述文件，禁止同时保留两个版本的psycopg2包，避免路径或版本冲突。
• 基于Lambda兼容环境重新安装依赖
  最稳定的方式是使用AWS官方SAM构建镜像安装依赖，无需额外启动EC2实例，执行命令时工作目录切换到函数代码根目录即可。
  Python3.9 x86_64环境参考命令：

  docker run --rm -v $(pwd):/var/task public.ecr.aws/sam/build-python3.9:latest pip install psycopg2-binary -t /var/task
  

  arm64架构环境添加平台参数即可：

  docker run --rm --platform=linux/arm64 -v $(pwd):/var/task public.ecr.aws/sam/build-python3.9:latest pip install psycopg2-binary -t /var/task
  

  安装完成后将当前目录的代码+依赖打包为zip上传即可，也可将依赖单独打包为Lambda层挂载使用。如果不想本地构建，也可以直接使用匹配函数版本、架构的预编译psycopg2 Lambda层，挂载后无需手动打包依赖。
• 校验包路径正确性
  打包完成后解压zip包确认，psycopg2文件夹必须直接位于zip包根目录，和lambda_function.py文件同级，不要嵌套在其他子目录下，否则Lambda运行时的Python搜索路径无法定位到对应模块。可临时添加调试代码打印搜索路径做校验：

  import sys
  def lambda_handler(event, context):
      print(sys.path)
      # 原有业务逻辑
  

避坑提示：禁止直接在macOS M系列芯片、Windows本地环境pip安装依赖后直接打包，这类环境编译出的C扩展二进制无法在Lambda Linux环境运行，必然触发该类导入错误。

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