在AWS Lambda Docker镜像中安装psycopg2失败：pg_config可执行文件未找到

先解决psycopg2的安装问题 #

你遇到的Error: pg_config executable not found是因为Lambda基础镜像默认缺少PostgreSQL系统开发依赖，可通过两种方式修复：

方式1：改用预编译的psycopg2-binary #

psycopg2-binary是打包好的二进制版本，无需系统依赖，直接替换requirements.txt内容：

psycopg2-binary>=2.9.9

或在Dockerfile中执行：

RUN pip3 install psycopg2-binary

方式2：先安装系统依赖再装原生psycopg2 #

如果坚持用原生psycopg2，需先在Dockerfile中安装PostgreSQL开发包：

• 基于Amazon Linux 2/CentOS的镜像：

RUN yum install -y postgresql-devel gcc python3-devel
RUN pip3 install psycopg2

• 基于Debian/Ubuntu的镜像：

RUN apt-get update && apt-get install -y libpq-dev gcc python3-dev
RUN pip3 install psycopg2

其他访问PostgreSQL的替代方案 #

如果不想依赖psycopg2，这些纯Python或轻量驱动更适配Lambda环境：

• pg8000：纯Python实现的驱动，无系统依赖，直接安装即可：

  pg8000>=1.30.2
  

  使用示例：

  import pg8000.native
  conn = pg8000.native.Connection(
      user="你的用户名",
      password="你的密码",
      host="数据库地址",
      database="目标数据库"
  )
  cursor = conn.cursor()
  cursor.execute("SELECT * FROM 你的表名")
  rows = cursor.fetchall()
  conn.close()
  

• asyncpg：高性能异步驱动，适合异步Lambda函数：

  asyncpg>=0.29.0
  

  使用示例：

  import asyncpg
  async def handler(event, context):
      conn = await asyncpg.connect(
          user="你的用户名",
          password="你的密码",
          host="数据库地址",
          database="目标数据库"
      )
      rows = await conn.fetch("SELECT * FROM 你的表名")
      await conn.close()
      return {"data": rows}
  

• SQLAlchemy + 适配驱动：如果用ORM框架，可搭配pg8000或psycopg2-binary：

  SQLAlchemy>=2.0.25
  pg8000>=1.30.2
  

  使用示例：

  from sqlalchemy import create_engine, text
  engine = create_engine("postgresql+pg8000://用户名:密码@地址/数据库名")
  with engine.connect() as conn:
      result = conn.execute(text("SELECT * FROM 你的表名"))
      rows = result.fetchall()
  

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