AWS Lambda（Python）：Docker容器安装psycopg2遇SCRAM认证问题及部署建议咨询

你遇到的psycopg2.OperationalError: SCRAM authentication requires libpq version 10 or above错误，核心原因确实是容器内的libpq库版本低于10——默认的Amazon Linux 2基础镜像里的PostgreSQL相关包版本比较旧。下面是几个经过验证的解决方案，按推荐程度排序：

方案1：改用psycopg2-binary替代原生psycopg2 #

这是最简单的解决方式，psycopg2-binary是预编译好的二进制包，不需要依赖系统的libpq库，完全绕开了编译和版本匹配的问题。

步骤： #

1. 修改你的requirements.txt，把psycopg2==2.9.1替换为：

pandas==1.3.0
requests==2.25.1
psycopg2-binary==2.9.1
pgcopy==1.5.0

2. 简化Dockerfile，去掉编译相关的依赖安装（因为不需要gcc和postgresql-devel了）：

FROM public.ecr.aws/lambda/python:3.8
WORKDIR /app
COPY my_script.py .
COPY some_file.csv .
COPY requirements.txt .
RUN pip install -r requirements.txt
CMD ["/app/my_script.handler"]

这个方案的优势是快速、无编译环节，镜像体积也更小，在Lambda环境中兼容性良好。

方案2：手动升级容器内的libpq到10+版本 #

如果你坚持要用原生psycopg2（比如担心二进制包的兼容性），可以通过Amazon Linux的extras仓库安装高版本的PostgreSQL库：

修改后的Dockerfile： #

FROM public.ecr.aws/lambda/python:3.8
WORKDIR /app
COPY my_script.py .
COPY some_file.csv .
COPY requirements.txt .

# 安装PostgreSQL 10的开发库和编译工具
RUN amazon-linux-extras install postgresql10 -y && \
    yum install -y postgresql-devel gcc && \
    yum clean all && rm -rf /var/cache/yum

# 安装依赖
RUN pip install -r requirements.txt

CMD ["/app/my_script.handler"]

amazon-linux-extras install postgresql10会把系统的libpq升级到10版本，满足SCRAM认证的要求。安装后可以进入容器验证版本：

docker run --rm -it <your-image> bash
pg_config --version
# 应该输出 PostgreSQL 10.x

方案3：升级Lambda Python基础镜像版本 #

如果你的Python脚本兼容更高版本的Python，可以切换到更新的Lambda镜像，比如public.ecr.aws/lambda/python:3.9或3.10——这些镜像基于更新的Amazon Linux 2版本，默认的libpq版本通常已经满足10+的要求。

比如切换到3.9版本的Dockerfile开头：

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

之后保持原来的安装步骤即可，记得确认你的脚本在Python 3.9环境下能正常运行。

额外验证步骤 #

构建镜像后，建议本地运行容器测试连接：

docker run --rm -e DB_HOST=<your-host> -e DB_USER=<user> -e DB_PASS=<pass> -e DB_NAME=<db> <your-image>

确保不会再出现SCRAM认证的错误。

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