AWS Node.js Lambda Layer报错：无法打开共享对象文件

核心原因 #

• 架构不兼容：如果Docker编译用的Lambda镜像架构（x86-64/ARM64）和实际部署的Lambda架构不一致，编译出的bcrypt二进制文件和运行时环境不匹配，导致Lambda找不到对应架构的bcrypt_lib.node文件。比如容器用x86镜像编译，但Lambda跑在ARM上，自然找不到x86版本的二进制文件。
• NAPI版本不匹配：Node.js 18对应的NAPI版本可能和你编译时容器内的环境存在细微差异，或者编译时未正确指定目标NAPI版本，导致生成的绑定文件路径中的napi-v3和Lambda运行时预期的路径不匹配。
• 打包时文件遗漏：虽然Layer结构符合要求，但打包过程中可能未完整复制bcrypt的二进制文件——比如用了过滤性的复制命令，忽略了深层目录的文件，或者容器内编译生成的文件本身就不完整。
• 依赖安装参数错误：安装bcrypt时未使用--build-from-source参数，导致安装的是预编译的通用包，而非适配容器架构和Node.js版本的本地编译包，进而在Lambda运行时无法加载。

排查与修复步骤 #

• 严格匹配架构：确认Lambda运行的架构，使用对应版本的Lambda Docker镜像，比如x86用public.ecr.aws/lambda/nodejs:18-x86_64，ARM64用public.ecr.aws/lambda/nodejs:18-arm64。
• 强制源码编译：在容器内执行npm install bcrypt --build-from-source，确保bcrypt基于当前容器的架构和Node.js版本编译出适配的二进制文件。
• 验证编译结果：编译完成后，检查容器内node_modules/bcrypt/lib/binding/目录，确认napi-v3文件夹存在且包含bcrypt_lib.node文件。
• 完整打包Layer：用cp -r nodejs/ ./layer-content/这类命令完整复制所有文件，避免用通配符或选择性复制导致文件遗漏。
• 部署后验证：在Lambda控制台查看Layer的内容，确认/opt/nodejs/node_modules/bcrypt/lib/binding/napi-v3/下存在对应的二进制文件。

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