AWS Lambda函数无法识别外部Python库PyMuPDF问题求助

问题排查与解决方法 #

1. 层的目录结构不符合Lambda要求 #

AWS Lambda Python层对打包结构有强制要求，库文件必须放在特定路径下才能被运行环境自动识别：

• 通用兼容结构：ZIP包根目录下直接创建python文件夹，所有依赖库直接放到该文件夹内
• 版本严格匹配结构：按python/lib/<Python版本>/site-packages/路径存放，比如你用Python3.9运行时，路径就是python/lib/python3.9/site-packages/
  你当前的ZIP包内用了python_library作为外层目录，Lambda运行时无法识别该路径，自然找不到PyMuPDF库。

2. 依赖包架构与运行环境不匹配 #

PyMuPDF包含C语言扩展，属于二进制依赖包，不同操作系统、不同CPU架构的包不能通用：

• 如果你直接在Windows/macOS本地下载的PyPI包，对应的是本地系统架构，无法在Lambda的Amazon Linux运行环境中使用
• 如果你的Lambda用的是x86_64架构，需要下载对应manylinux2014_x86_64标签的wheel包；如果是arm64架构，需要下载manylinux2014_aarch64标签的wheel包

正确操作步骤 #

• 优先在与Lambda运行环境一致的系统中安装依赖，比如启动对应版本的Amazon Linux EC2实例，或者用Docker拉取amazonlinux镜像执行安装
• 安装时指定对应架构，执行命令示例：

pip install \
--platform manylinux2014_x86_64 \
--target=./python/lib/python3.9/site-packages \
--implementation cp \
--python-version 3.9 \
--only-binary=:all: --upgrade \
pymupdf==1.18.10

注意把命令中的Python版本替换成你Lambda实际使用的版本，架构参数也对应调整

• 进入python文件夹的同级目录，全选内容打包为ZIP，确保解压后根目录直接是python文件夹，没有额外的外层目录
• 将打包好的ZIP上传为Lambda层，绑定到函数即可正常调用

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