AWS Lambda使用connectorx库报错：找不到module 'connectorx.connectorx'

问题分析 #

你遇到的No module named 'connectorx.connectorx'错误，核心原因通常是两种情况：

• 本地安装的connectorx包不兼容Lambda的Amazon Linux运行环境，导致库内部结构缺失或二进制文件无法加载
• ZIP包/层的结构不符合Lambda的模块搜索规则

解决方案 #

1. 重新安装兼容Lambda环境的connectorx包 #

Lambda使用Amazon Linux 2 x86_64架构环境，直接在Windows/macOS安装的包会因系统架构差异出现导入异常。请执行以下命令安装兼容包：

pip install connectorx==0.3.1 --platform manylinux2014_x86_64 --only-binary=:all: -t .

执行后，当前目录会生成适配Lambda的connectorx文件夹和connectorx-0.3.1.dist-info文件夹。

2. 修正ZIP包结构 #

确保部署包的结构符合Lambda的模块搜索逻辑（lambda_function.py需和connectorx处于同一根目录）：

my-deployment.zip
├── connectorx/
│   ├── __init__.py
│   ├── connectorx.py  # 或对应内部子模块结构
│   └── 其他库依赖文件
├── connectorx-0.3.1.dist-info/
└── lambda_function.py

注意：若你将lambda_function.py放在src子目录下，需在Lambda控制台将"处理程序"配置为src.lambda_function.handler，否则Python无法在根目录找到connectorx模块。

3. 层的正确配置（若使用层） #

如果用Lambda层托管依赖，层的ZIP包必须以python目录为根，结构如下：

layer.zip
└── python/
    ├── connectorx/
    └── connectorx-0.3.1.dist-info/

创建层后将其附加到Lambda函数，Lambda会自动把python目录加入模块搜索路径。

4. 调试模块搜索路径（可选） #

若问题仍存在，可在lambda_function.py开头添加调试代码，查看Lambda的模块搜索路径：

import sys
print("Module search paths:", sys.path)

通过CloudWatch日志确认ZIP根目录或层的python目录是否在sys.path列表中。

验证 #

重新打包部署后，测试import connectorx as cx语句，即可正常导入库。

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