为何zbar库无法上传至Amazon Lambda？Docker+Zappa部署Django遇阻

我之前也碰到过类似的情况，Lambda运行环境默认没有zbar的共享库，虽然你在Docker构建镜像里装了，但Zappa打包时没把这些库包含进去，而且直接用yum装的包体积太大还容易触发Lambda的压缩包限制。咱们一步步来解决：

核心问题分析 #

Lambda的运行环境是精简版的Amazon Linux，没有预装zbar库；而你在build镜像里安装的zbar库并没有被Zappa打包到部署包中，导致运行时找不到共享库。另外yum安装的zbar会带很多依赖，直接打包会让部署包体积超标。

解决方案1：手动复制共享库并配置Zappa打包 #

步骤1：在Docker容器中定位zbar共享库 #

启动你的Docker容器后，执行以下命令找到zbar的共享库位置：

find / -name "libzbar.so*"

通常你会得到类似/usr/lib64/libzbar.so.0、/usr/lib64/libzbar.so.0.3.0这样的路径。

步骤2：将共享库复制到项目目录 #

在你的Django项目根目录创建一个lib文件夹，然后把找到的所有libzbar相关文件复制进去：

mkdir -p /var/task/lib
cp /usr/lib64/libzbar.so* /var/task/lib/

步骤3：修改Zappa配置文件 #

更新你的Zappa设置，添加include字段把lib目录包含进部署包，同时设置LD_LIBRARY_PATH环境变量让Python能找到这个库：

{
  "dev": {
    "django_settings": "library.settings",
    "profile_name": null,
    "project_name": "backend",
    "runtime": "python3.6",
    "s3_bucket": "bucket",
    "include": ["lib/**"],
    "environment_variables": {
      "LD_LIBRARY_PATH": "/var/task/lib"
    }
  }
}

步骤4：重新打包部署 #

在Docker容器中重新安装依赖并执行Zappa更新：

pip install -r requirements.txt
zappa update dev

解决方案2：使用静态编译的zbar减少包体积 #

如果yum安装的zbar体积太大，咱们可以自己编译静态版的zbar，去掉不必要的依赖：

步骤1：在Docker容器中编译zbar #

# 安装编译依赖
yum install -y gcc make autoconf automake libtool pkg-config git
# 克隆zbar源码
git clone https://github.com/mchehab/zbar.git
cd zbar
# 配置编译选项，禁用不需要的模块
./autogen.sh
./configure --enable-static --disable-shared --without-gtk --without-qt --without-python --disable-video
# 编译
make
# 复制编译好的共享库到项目lib目录
cp src/.libs/libzbar.so* /var/task/lib/

步骤2：后续操作同方案1 #

复制完库后，修改Zappa配置并重新部署即可，这样编译出来的库体积会小很多，不容易触发打包大小限制。

验证步骤 #

在Docker容器里先验证配置是否生效：

export LD_LIBRARY_PATH=/var/task/lib
python -c "from pyzbar.pyzbar import decode; print('pyzbar imported successfully!')"

如果没有报错，说明配置正确，再执行zappa update dev就不会出现ImportError了。

额外优化：减小部署包体积 #

如果还是碰到包过大的问题，可以在Zappa配置里添加exclude字段排除不必要的文件：

"exclude": [
  "**/__pycache__/**",
  "tests/**",
  "static/**",
  "media/**"
]

（如果你的静态文件托管在S3上，就可以排除static目录）

内容的提问来源于stack exchange，提问作者Anton De Meester