AWS Lambda（Windows环境）python-oracledb导入失败求助

需通过Lambda Layer连接AWS RDS Oracle实例并获取数据，使用轻量型驱动python-oracledb时反复出现No module named 'oracledb'错误。本地为Windows系统，Oracle RDS部署在Windows EC2实例上，该问题已持续两天，此前尝试cx_oracle搭配Oracle客户端时遇到上传错误及大小限制。

错误信息 #

[ERROR] Runtime.ImportModuleError: Unable to import module 'lambda_function': No module named 'oracledb'
Traceback (most recent call last)
RequestId: 87f11785-14c0-4a8c-8dbf-61be98995b82
REPORT RequestId: 87f11785-14c0-4a8c-8dbf-61be98995b82 Duration: 3.22 ms Billed Duration: 4 ms Memory Size: 128 MB Max Memory Used: 61 MB Init Duration: 255.42 ms

已执行步骤 #

• 创建Lambda Layer目录：

  mkdir lambda_layer
  cd lambda_layer
  mkdir python
  

• 安装oracledb包：

  pip install oracledb -t ./python
  

• 生成Layer压缩包：

  cd python
  zip -r ../python_oracledb_layer.zip .
  

• 已上传压缩包，尝试过Python 3.12及其他运行时，错误依旧。

解决方案 #

1. 修复跨平台依赖问题（核心原因） #

Lambda运行环境为Linux，Windows下安装的python-oracledb包含Windows专属二进制文件，无法在Linux环境加载，必须在Linux环境编译安装：

方法一：用Docker模拟Lambda环境

# 拉取对应Python版本的Lambda镜像（以Python3.12为例）
docker pull public.ecr.aws/lambda/python:3.12

# 运行容器并挂载本地目录
docker run -v "$PWD:/var/task" -it public.ecr.aws/lambda/python:3.12 bash

# 在容器内创建目录并安装oracledb
mkdir -p lambda_layer/python
pip install oracledb -t lambda_layer/python --no-cache-dir --only-binary :all:

# 退出容器后打包
cd lambda_layer/python
zip -r ../python_oracledb_layer.zip .

方法二：用AWS CloudShell

直接在CloudShell中执行操作，环境与Lambda完全兼容：

mkdir -p lambda_layer/python
pip install oracledb -t lambda_layer/python --no-cache-dir
cd lambda_layer/python
zip -r ../python_oracledb_layer.zip .

2. 检查压缩包结构 #

确保解压后目录结构为python/oracledb/...，而非多层嵌套（如lambda_layer/python/oracledb）。可本地解压压缩包验证，结构错误则重新打包。

3. 匹配运行时与Python版本 #

Lambda函数的运行时版本（如Python3.12）必须与安装oracledb时使用的Python版本完全一致，避免版本不兼容导致模块无法识别。

4. 确认Layer关联正确 #

在Lambda函数的Layers配置中，确认已添加创建的python_oracledb_layer，且选择了正确版本。

5. 排查网络连通性 #

确保Lambda所在VPC可访问RDS Oracle实例：

• Lambda已配置到包含RDS的VPC子网
• 安全组允许Lambda的IP访问RDS的1521端口
• RDS实例的公有访问或私有网络路由正常

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