Lambda报Runtime.InvalidEntrypoint错误：Docker镜像入口点配置困惑

我有一个包含lambda_handler处理函数的Python脚本，用指定Dockerfile构建容器镜像推送到ECR后创建Lambda函数，测试时触发如下错误：

{
  "errorType": "Runtime.InvalidEntrypoint",
  "errorMessage": "RequestId: 86339395-a02e-4122-b54e-9f80a7bfbd40 Error: exec: \"lambda_function.lambda_handler\": executable file not found in $PATH"
}

因为用的是M2 Mac，一开始怀疑是架构问题，已经用docker buildx build --platform linux/amd64 -t lambda-function .构建了amd64适配镜像，但测试Lambda还是报无效入口点，不知道该配置什么入口点。

1. 优先使用AWS官方Lambda基础镜像 #

Lambda容器镜像的核心问题通常出在基础镜像选择和入口配置上，直接用AWS提供的Python运行时基础镜像（比如public.ecr.aws/lambda/python:3.12）可以避免大部分配置问题——这类镜像内置了Lambda运行时环境，会自动处理入口逻辑。

标准的Dockerfile示例：

# 指定官方Python Lambda基础镜像（替换成你用的Python版本）
FROM public.ecr.aws/lambda/python:3.12

# 把你的Python脚本复制到Lambda默认工作目录/var/task
COPY lambda_function.py ${LAMBDA_TASK_ROOT}

# 若你的脚本名不是lambda_function.py，或函数名不是lambda_handler，才需要手动指定CMD：
# CMD ["custom_script.your_handler_function"]

2. 检查Lambda控制台的容器配置 #

在AWS控制台创建Lambda函数时，注意容器镜像的入口点和命令设置：

• 用官方基础镜像的话，这两个字段可以留空，Lambda会默认读取镜像内置的配置，自动查找lambda_function.lambda_handler
• 若你的脚本/函数名自定义了，在“命令”字段填写["脚本名.函数名"]（比如["app.main"]），不要填在入口点字段——入口点一般是指向Lambda运行时的执行程序，不是你的处理函数。

3. 本地验证镜像（排查用） #

如果还是有问题，用Lambda Runtime Interface Emulator在本地测试镜像，确认镜像本身没问题：

1. 下载RIE：curl -Lo aws-lambda-rie https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie && chmod +x aws-lambda-rie
2. 启动容器：docker run -p 9000:8080 lambda-function
3. 发送测试请求：curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'
   如果本地能正常返回结果，说明镜像配置没问题，再去检查Lambda控制台的设置是否正确。

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