容器中用Bootstrap脚本启动AWS Lambda时遇执行格式错误

可能的原因及修复方案 #

1. Bootstrap脚本缺少Shebang头 #

如果你的bootstrap是shell脚本，必须在第一行添加脚本解释器声明，比如#!/bin/bash或#!/bin/sh，否则Lambda会将其当作二进制文件执行，直接触发格式错误。
示例正确开头：

#!/bin/bash
# 后续Tailscale初始化、Lambda handler调用逻辑

2. 脚本未设置可执行权限 #

Docker构建过程中要确保bootstrap脚本拥有执行权限，在Dockerfile中添加：

COPY bootstrap /var/runtime/bootstrap
RUN chmod +x /var/runtime/bootstrap

本地文件的执行权限不会自动同步到容器内，必须显式设置。

3. 架构不匹配 #

Lambda运行环境的架构（x86_64/arm64）必须与你构建的镜像、Tailscale二进制包完全一致。比如在M1 Mac上默认构建arm64镜像，但Lambda使用x86_64环境时就会报错。
解决：构建时指定目标架构的基础镜像，例如：

# x86_64环境用这个镜像
FROM public.ecr.aws/lambda/provided:al2023-x86_64
# arm64环境替换为al2023-arm64

同时下载对应架构的Tailscale二进制包。

4. 脚本调用的二进制架构不匹配 #

如果bootstrap脚本中调用了Tailscale二进制文件，要确保该二进制是Lambda运行架构的版本——x86_64的二进制无法在arm64环境运行，反之亦然。

5. 路径或文件名错误 #

确保容器内的bootstrap文件路径为/var/runtime/bootstrap，且文件名全小写（Lambda对路径大小写敏感）。

本地验证步骤 #

启动容器测试：

docker run --rm -p 9000:8080 your-image-tag

然后发起调用请求验证：

curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

可以快速复现错误或验证修复效果。

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