AWS Lambda导入Layer依赖遇Runtime.ImportModuleError错误求助

问题根源
AWS Lambda的运行时基于Amazon Linux环境，使用的是glibc标准库。你的依赖包大概率是在使用musl libc的系统（比如Alpine Linux）下编译打包的，导致Lambda环境无法识别musl相关的库文件，触发导入错误。

解决步骤 #

1. 使用Amazon Linux环境编译打包依赖 #

Lambda的运行环境和Amazon Linux完全一致，用这个环境打包的依赖不会出现库兼容问题：

• 用Docker启动Amazon Linux 2容器：

  docker pull amazonlinux:2
  docker run -v $(pwd):/local -it amazonlinux:2 /bin/bash
  

• 在容器内安装对应版本的Python和pip（替换为你的Lambda运行时版本，比如3.9）：

  yum install -y python39 python39-pip
  

• 安装依赖到指定目录：

  pip3.9 install 你的依赖包名 -t /local/python/lib/python3.9/site-packages --no-cache-dir
  

• 退出容器后，将python目录打包成zip文件，上传为Lambda Layer。

2. 强制使用兼容glibc的预编译轮子 #

很多Python包提供了针对manylinux标准的预编译轮子，这些轮子兼容glibc环境，避免从源码编译依赖musl：

pip3 install 你的依赖包名 -t ./python/lib/python3.9/site-packages --only-binary :all: --no-cache-dir

3. 检查Layer的目录结构 #

确保Layer的zip包解压后，依赖文件的路径符合Lambda的要求：

python/
  lib/
    pythonX.Y/  # X.Y为你的Lambda Python版本，比如3.9
      site-packages/
        [所有依赖包文件]

Lambda会自动将这个路径加入Python的sys.path，错误的路径会导致无法识别依赖。

4. 清理不必要的系统文件 #

打包前删除依赖目录中多余的系统特定库文件，避免引入musl相关文件：

rm -rf ./python/lib/python3.9/site-packages/**/*.so.*

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