AWS Lambda(Python3.11)导入psycopg2报错：找不到psycopg2._psycopg模块

问题根源 #

psycopg2包含C扩展模块，必须在与AWS Lambda运行环境完全兼容的系统中构建，否则编译出的二进制文件无法在Lambda环境中加载，导致找不到psycopg2._psycopg模块。你之前使用的Docker环境可能和Lambda的Amazon Linux 2023（Python3.11对应的Lambda运行环境）不匹配。

正确构建步骤 #

1. 使用Lambda官方镜像构建层 #

Lambda的Python3.11运行环境基于Amazon Linux 2023，直接用官方提供的Docker镜像构建：

# 拉取Lambda Python3.11官方镜像
docker pull public.ecr.aws/lambda/python:3.11

# 运行容器并挂载当前目录到容器内
docker run -v "$PWD":/var/task public.ecr.aws/lambda/python:3.11 bash

# 在容器内创建层目录结构
mkdir -p layer/python/lib/python3.11/site-packages

# 安装psycopg2-binary（预编译版本，无需依赖系统编译环境）
pip3 install psycopg2-binary -t layer/python/lib/python3.11/site-packages/

# 退出容器
exit

# 打包层文件
cd layer && zip -r layerpsycopg2.zip *

2. 验证层结构 #

解压打包后的zip包，确认目录结构符合Lambda要求：

unzip -l layerpsycopg2.zip

输出应包含python/lib/python3.11/site-packages/psycopg2/，且其中存在_psycopg.cpython-311-x86_64-linux-gnu.so这类二进制文件。

3. 重新上传并关联层 #

• 将新打包的layerpsycopg2.zip上传到AWS Lambda层
• 确保你的Lambda函数运行时为Python3.11，并关联该层的最新版本

关于aws-psycopg2的注意事项 #

如果使用aws-psycopg2，同样需要在Lambda官方镜像中安装，替换上述安装命令为：

pip3 install aws-psycopg2 -t layer/python/lib/python3.11/site-packages/

避免在本地或非兼容环境安装，否则同样会出现二进制不兼容问题。

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