将AWS Lambda Python 2.7升级至3.9：依赖库处理疑问

一、核心依赖的升级必要性判断 #

• cx_Oracle：当前使用的7.0.0版本仅支持到Python 3.7，Python 3.9必须升级。官方已将cx_Oracle更名为oracledb（1.0+版本），完全兼容Python 3.9，且性能、维护性更优。
• lxml：Python 2.7适配的lxml版本与3.9不兼容，需升级到支持3.9的稳定版（如4.6.0及以上）。
• lib：若为系统级依赖（如lxml所需的libxml2、libxslt），Lambda Python 3.9运行时已预装适配版本，无需额外打包；若为自定义Python库，需确认其是否支持3.9，不支持则需升级该库或寻找替代方案。

二、依赖升级实操步骤 #

1. 搭建本地Python 3.9隔离环境
   用虚拟环境避免全局依赖冲突：

   python3.9 -m venv lambda-venv
   source lambda-venv/bin/activate # Linux/macOS
   # Windows执行：lambda-venv\Scripts\activate
   

2. 安装适配依赖
   • 替换cx_Oracle为oracledb：

     pip install oracledb
     

   • 安装兼容Python 3.9的lxml：

     pip install lxml
     

   • 自定义lib确认支持3.9后重新安装，无兼容版本则替换为Python 3.x可用的替代库。
3. 适配Lambda环境打包
   Lambda基于Amazon Linux 2运行，本地打包需保证依赖兼容性：
   • 用Docker模拟Lambda环境打包，或在EC2的Amazon Linux 2实例中安装依赖后打包。
   • 仅打包site-packages下的依赖文件，不要包含虚拟环境本身。
4. 代码适配调整
   • oracledb替代cx_Oracle后，修改导入语句：

     # 原代码
     import cx_Oracle
     # 修改后
     import oracledb
     

   • 测试lxml核心逻辑（如XML解析、xpath查询），确认高版本API兼容。
5. 测试验证
   • 本地用Python 3.9运行函数，验证数据库连接、XML处理等依赖相关逻辑。
   • 上传至Lambda后，触发测试并通过CloudWatch日志排查报错。

三、关键注意事项 #

• 禁止直接将Python 2.7的依赖包复制到3.9环境，会因字节码、API差异导致兼容性错误。
• oracledb支持thin模式直接连接数据库，无需额外打包Oracle客户端，可减小部署包体积。
• 若存在仅支持Python 2.x的自定义lib，需重构对应逻辑，改用Python 3.x标准库或替代包实现。

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