在AWS Lambda层运行opencv-python-headless遇ZLIB_1.2.9缺失错误求助

这个错误的核心原因是：Lambda运行环境（比如Amazon Linux 2）自带的zlib版本低于1.2.9，而直接通过pip安装的opencv-python-headless依赖的libpng库需要更高版本的zlib，从而触发导入失败。

下面是几个可行的解决办法：

方法一：用Lambda兼容环境打包opencv层 #

不要在本地直接pip安装，改用Amazon Linux 2的Docker镜像构建，确保依赖和Lambda环境完全匹配：

• 拉取对应Python版本的Lambda构建镜像：docker pull public.ecr.aws/sam/build-python3.8（把3.8换成你用的Python版本）
• 启动容器并挂载本地目录：docker run -v $(pwd):/app -it public.ecr.aws/sam/build-python3.8 /bin/bash
• 在容器内创建Lambda层要求的目录结构：mkdir -p python/lib/python3.8/site-packages
• 将opencv-python-headless安装到该目录：pip install opencv-python-headless -t python/lib/python3.8/site-packages/
• 退出容器后，把python目录打包成zip：zip -r opencv-layer.zip python/
• 把这个zip上传到你的Lambda层即可

方法二：手动替换层中的zlib库 #

如果已经有打包好的层，可以手动加入兼容的zlib库：

• 从Amazon Linux 2环境中获取或编译zlib 1.2.9版本的库文件libz.so.1.2.9
• 在层的根目录创建lib文件夹，把libz.so.1.2.9放进去，同时创建软链接：ln -s libz.so.1.2.9 libz.so.1
• 给Lambda函数添加环境变量LD_LIBRARY_PATH=/opt/lib:$LD_LIBRARY_PATH，让系统优先加载层里的zlib库

方法三：强制使用兼容二进制包 #

尝试用pip强制安装适配Lambda环境的二进制包：
pip install opencv-python-headless --only-binary=:all:
不过这个方法不一定百分百有效，优先推荐方法一的Docker构建方式。

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