AWS Lambda本地Docker运行正常，SAM与线上部署异常求助

1. 解决Init failed error=Runtime exited without providing a reason错误 #

这个错误是Lambda运行时初始化失败，核心原因是镜像入口配置不符合Lambda Runtime API要求：
你当前的ImageConfig.EntryPoint设置为["python3", "lambda_function.py"]，会直接执行脚本，但Lambda镜像需要通过Runtime Interface Emulator（RIE）处理与平台的交互，或者脚本严格实现Runtime API规范（Python场景下没必要，用官方运行时更简单）。

修复步骤： #

方法1：使用官方Python Lambda基础镜像并配置handler

修改Dockerfile基于官方Python Lambda镜像，无需手动配置RIE：

FROM public.ecr.aws/lambda/python:3.12
COPY . ${LAMBDA_TASK_ROOT}
# 安装依赖（如果有）
RUN pip install -r requirements.txt

同步修改SAM模板的ImageConfig，指定handler路径（文件名.函数名）：

ImageConfig:
  Command: [ "lambda_function.lambda_handler" ]
  WorkingDirectory: "/var/task/"

方法2：自定义镜像需手动集成RIE

如果坚持用自定义基础镜像，需在Dockerfile中安装RIE并设置为入口：

# 安装RIE
RUN curl -Lo /usr/local/bin/aws-lambda-rie https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie && \
    chmod +x /usr/local/bin/aws-lambda-rie
# 配置RIE为入口，指定handler
ENTRYPOINT [ "/usr/local/bin/aws-lambda-rie" ]
CMD [ "python3", "-m", "awslambdaric", "lambda_function.lambda_handler" ]

SAM模板的ImageConfig可简化为：

ImageConfig:
  WorkingDirectory: "/var/task/"

2. 解决Postman返回整个response对象、请求头无法获取的问题 #

问题根源： #

• 直接访问http://localhost:9000测试Docker容器是错误的，Lambda invocation的正确端点是http://localhost:9000/2015-03-31/functions/function/invocations，该端点返回函数原始返回值，不会自动转换为HTTP响应。
• 你配置了PayloadFormatVersion: "2.0"，HttpApi会将请求头、body等信息封装到event对象中，函数需正确解析该结构才能获取请求头。

修复步骤： #

确保函数正确处理HttpApi 2.0格式事件

Python函数需从event参数中提取请求头和body，示例：

import json

def lambda_handler(event, context):
    # 获取请求头
    request_headers = event.get('headers', {})
    # 获取请求体
    request_body = event.get('body', '')
    
    # 构造符合HttpApi要求的响应
    return {
        'statusCode': 200,
        'headers': {
            'Content-Type': 'application/json',
            'Access-Control-Allow-Origin': '*'
        },
        'body': json.dumps({'message': 'success', 'received_headers': request_headers})
    }

正确测试HTTP API触发场景

用sam local start-api启动本地API网关，访问http://localhost:3000/input（默认端口3000），此时API网关会自动将HTTP请求转换为Lambda event，并将函数响应解析为标准HTTP响应（headers和body会正确映射）。

3. 解决CORS报错Response body is not available to scripts (Reason: CORS Missing Allow Origin) #

在函数返回的headers中添加Access-Control-Allow-Origin字段（如上述函数示例），如需严格控制可替换为具体域名而非*。

额外验证步骤 #

1. 重新构建镜像：sam build
2. 本地测试Lambda函数：sam local invoke MyFunction -e event.json（event.json可模拟HttpApi 2.0格式事件）
3. 本地测试API网关：sam local start-api，用Postman调用POST http://localhost:3000/input
4. 线上部署：sam deploy --guided

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