如何在AWS Lambda Python3.9环境中正常运行psycopg 3

AWS Lambda 官方Python 3.9基础镜像内置的系统级libpq为PostgreSQL 9.2配套老旧版本，缺少psycopg 3依赖的PQconninfo等新增接口，直接通过pip安装源码版psycopg时会调用系统旧libpq，触发符号缺失错误；单独安装psycopg-binary不会自动安装psycopg主包，因此会触发No module named 'psycopg'报错。

方案1：安装psycopg[binary]预编译包（零额外系统依赖，推荐） #

psycopg 3的二进制发行版通过extra依赖方式分发，单独安装psycopg-binary不会安装主包，必须按如下方式安装：

FROM public.ecr.aws/lambda/python:3.9 

# 安装带预编译libpq的psycopg3，无需额外升级系统依赖
RUN pip install "psycopg[binary]"

COPY . . 

# 本地调试可临时使用该入口，正式部署Lambda时需删除该行，使用镜像默认入口
ENTRYPOINT ["python", "script.py"]

该方案中psycopg-binary自带静态编译的新版libpq，完全不依赖系统内置的旧版本libpq，兼容性最好，部署体积增量也最小。

方案2：升级系统libpq后安装源码版psycopg（适合需要自定义libpq版本的场景） #

如果需要使用源码编译版psycopg，先在镜像中配置PostgreSQL官方yum源，安装10及以上版本的libpq，替换系统内置的旧版/lib64/libpq.so.5软链指向新版libpq，之后再执行pip install psycopg即可正常加载。

• 正式部署到Lambda环境时，必须删除自定义ENTRYPOINT配置，使用镜像默认的Lambda运行时入口，否则函数无法正常处理触发事件。
• Lambda运行环境默认不提供公网访问能力，若数据库不在Lambda同VPC内，需要配置NAT网关或VPC端点保证网络连通；同VPC内需要给Lambda配置正确的安全组规则，允许访问数据库端口。
• 不要在同一项目中同时安装psycopg2和psycopg 3，两者底层依赖独立，混用可能出现不可预期的冲突。

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