AWS Lambda自定义基础镜像部署遇Runtime.InvalidEntrypoint错误求助

核心错误分析 #

报错里的fork/exec /lambda-entrypoint.sh: exec format error是关键，大概率是架构不匹配、脚本权限/格式问题，或者镜像不符合Lambda运行规范导致的。以下是针对性排查和解决步骤：

• 架构不匹配（最常见诱因）
  Lambda默认用x86_64架构运行环境，如果你在Apple Silicon（arm64）机器上构建镜像，默认生成的是arm64架构镜像，部署到x86_64环境就会触发格式错误。
  解决：构建镜像时指定x86_64架构：

  docker build --platform linux/amd64 -t your-image-tag .
  

  要是你想使用arm64架构，就在Lambda控制台创建函数时选择arm64作为架构选项。

• 检查entrypoint脚本的权限与格式

  • 必须给lambda-entrypoint.sh添加可执行权限，Dockerfile里加上：

    RUN chmod +x /lambda-entrypoint.sh
    

  • 脚本开头的shebang要正确，比如#!/bin/bash或#!/bin/sh，不能写错路径；另外脚本不能用Windows换行符（CRLF），要改成Unix换行符（LF），可以用dos2unix lambda-entrypoint.sh工具转换。

• 确保镜像符合Lambda运行规范
  用python:3.11.2-slim-bullseye做基础镜像，需要补充Lambda Runtime Interface Client（RIC）：

  RUN pip install awslambdaric
  

  同时Dockerfile里的ENTRYPOINT和CMD要正确配置，示例：

  ENTRYPOINT ["/lambda-entrypoint.sh"]
  CMD ["your-handler-module.your-function-name"]
  

  并且lambda-entrypoint.sh里要正确调用RIC，比如：

  #!/bin/sh
  exec /usr/local/bin/python -m awslambdaric "$@"
  

• 本地测试验证
  用Lambda Runtime Interface Emulator（RIE）本地模拟Lambda环境，提前发现问题：

  1. 安装RIE：

     mkdir -p ~/.aws-lambda-rie && curl -Lo ~/.aws-lambda-rie/aws-lambda-rie https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie && chmod +x ~/.aws-lambda-rie/aws-lambda-rie
     

  2. 运行镜像（指定架构）：

     docker run -p 9000:8080 --platform linux/amd64 your-image-tag
     

  3. 发送测试请求：

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

  本地运行如果报错，就能直接排查脚本或镜像的问题，不用反复部署到Lambda。

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