求助：创建Python 3.12版本AWS Lambda Layer集成pyodbc

核心问题根源 #

你遇到的问题本质是Lambda Python 3.12基于Amazon Linux 2023（AL2023）运行时，旧教程针对的是Amazon Linux 2（AL2）或更早版本，环境依赖完全不兼容，导致库路径、系统包版本不匹配。以下是针对AL2023环境的完整构建流程：

步骤1：用正确的Docker镜像构建环境 #

Lambda Python 3.12的底层环境是AL2023，必须使用对应镜像构建依赖：

# 拉取AL2023官方镜像
docker pull public.ecr.aws/amazonlinux/amazonlinux:2023

# 启动容器并挂载本地目录（当前目录会映射到容器内的/tmp/layer）
docker run -v "$PWD":/tmp/layer -it public.ecr.aws/amazonlinux/amazonlinux:2023

步骤2：在容器内安装系统依赖与ODBC驱动 #

AL2023默认用dnf包管理器，执行以下命令安装必要组件：

# 更新系统包
dnf update -y

# 安装Python3.12、unixODBC开发包（pyodbc编译依赖）
dnf install -y python3.12 python3.12-pip unixODBC-devel

# 添加微软SQL Server驱动的yum源
curl https://packages.microsoft.com/config/rhel/9/prod.repo > /etc/yum.repos.d/mssql-release.repo

# 安装ODBC Driver 18 for SQL Server（接受许可协议）
ACCEPT_EULA=Y dnf install -y msodbcsql18

步骤3：安装pyodbc并构建Layer目录结构 #

Lambda Layer要求固定目录结构：python/lib/pythonX.X/site-packages存放Python库，lib存放系统共享库：

# 创建Layer的Python库目录
mkdir -p /tmp/layer/python/lib/python3.12/site-packages

# 用pip3.12安装pyodbc到指定目录
pip3.12 install pyodbc -t /tmp/layer/python/lib/python3.12/site-packages

# 创建系统库目录，复制运行时需要的ODBC相关库
mkdir -p /tmp/layer/lib
cp /usr/lib64/libodbc.so.2 /tmp/layer/lib/
cp /usr/lib64/libodbcinst.so.2 /tmp/layer/lib/
cp /opt/microsoft/msodbcsql18/lib64/libmsodbcsql-18.3.so.2.1 /tmp/layer/lib/

步骤4：打包并上传Layer #

退出容器后，在本地目录打包：

cd /tmp/layer
zip -r pyodbc-layer.zip python lib

登录AWS控制台，上传该zip包作为Lambda Layer，指定兼容运行时为Python 3.12。

步骤5：测试Lambda函数 #

创建测试函数，关联上述Layer，示例代码：

import pyodbc

def lambda_handler(event, context):
    conn_str = (
        "DRIVER={ODBC Driver 18 for SQL Server};"
        "SERVER=<你的SQL服务器地址>;"
        "DATABASE=<数据库名>;"
        "UID=<用户名>;"
        "PWD=<密码>;"
        "Encrypt=yes;"
        "TrustServerCertificate=yes;"  # 若使用自签名证书需开启
    )
    try:
        conn = pyodbc.connect(conn_str)
        cursor = conn.cursor()
        cursor.execute("SELECT @@VERSION;")
        row = cursor.fetchone()
        return {"数据库版本": str(row[0])}
    except Exception as e:
        return {"错误信息": str(e)}

关键注意事项 #

• 不要使用旧的AL2镜像或预打包的Python 3.8 Layer：AL2023的系统库版本（如libodbc）与AL2完全不同，强行混用会导致找不到库的错误。
• 放弃pymssql：该库已停止维护多年，不支持Python 3.12及现代SQL Server版本，官方推荐使用pyodbc+微软ODBC驱动。
• 证书配置：如果SQL Server使用自签名证书，必须在连接字符串中添加TrustServerCertificate=yes，否则会出现SSL验证错误。

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