使用LocalStack与AWS SDK v3发布Lambda层时解压文件失败

遇到的错误提示：

InvalidParameterValueException: Could not unzip uploaded file. Please check your file, then try to upload again.

下面是针对性的排查方向和解决方法：

• 检查Lambda层压缩包结构是否合规
  Lambda层对zip包的目录结构有严格要求：Node.js层必须将node_modules放在zip包的根目录下，不能嵌套在其他文件夹中（比如解压后不能是my-layer/node_modules，必须直接是node_modules）。
  修正archiver打包逻辑，确保直接添加node_modules目录：

  const archiver = require('archiver');
  const fs = require('fs');
  const output = fs.createWriteStream('./layer.zip');
  const archive = archiver('zip', { zlib: { level: 9 } });
  
  output.on('close', () => console.log('打包完成'));
  archive.pipe(output);
  // 确保将node_modules直接作为zip根目录内容
  archive.directory('./node_modules', 'node_modules');
  archive.finalize();
  

• 验证压缩包格式兼容性
  部分压缩库可能生成LocalStack不兼容的zip格式，可先用系统原生zip命令重新打包测试：

  zip -r layer.zip node_modules
  

  如果用这个zip包能成功创建层，说明是archiver的配置或格式问题。

• 确认文件读取的buffer正确性
  使用fs.readFileSync时，必须获取原始二进制buffer，不能指定编码格式：

  // 传入null作为编码参数，确保返回原始buffer
  const zipBuffer = fs.readFileSync('./layer.zip', null);
  

  若指定了编码（如utf8），会将二进制文件转为字符串，导致上传后无法解压。

• 检查LocalStack配置与版本
  除了已设置的大小限制变量，确认LAMBDA_LAYERS_ENABLED环境变量为true（默认开启，可显式配置）；同时重启LocalStack容器确保环境变量生效：

  docker-compose down && docker-compose up -d
  

  若最新镜像存在bug，可尝试回退到稳定版本（如localstack/localstack:3.0.0）测试。

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