AWS API Gateway内部服务器错误排查：Lambda触发异常

我来帮你排查这个问题！这种情况在Lambda搭配API Gateway时挺常见的，咱们一步步来梳理可能的原因和解决办法：

1. 检查Lambda的返回格式是否符合API Gateway要求 #

Lambda控制台测试能正常返回，但API Gateway对返回格式有严格要求——body必须是JSON字符串，不能直接返回字典。你当前的返回里body是一个Python字典，API Gateway无法解析，就会抛出内部错误。

修改你的Lambda代码，用json.dumps()把响应体序列化为字符串，记得导入json模块：

import json

def lambda_handler(event, context):
    # 你的业务逻辑代码...
    
    response_body = {
        "bank": "my bank",
        "trust_name": "my trust",
        "start_time": "Wed 09 Oct 07:56AM",
        "end_time": "Wed 09 Oct 08:26AM",
        "cost": 111
    }
    
    return {
        "statusCode": 200,
        "body": json.dumps(response_body),
        "headers": {
            "Content-Type": "application/json"  # 建议加上，确保客户端正确解析响应
        }
    }

2. 查看CloudWatch日志定位具体错误 #

“Internal server error”是个泛泛的提示，最直接的方法是看日志找根源：

• Lambda日志：打开Lambda控制台，进入你的函数，切换到「Monitor」标签页，点击「Logs」查看最近的日志流。如果代码有报错（比如没导入json模块、未捕获的异常），这里会显示具体的错误信息。
• API Gateway日志：如果Lambda日志没异常，就开API Gateway的日志。进入API Gateway控制台，找到你的API，进入对应的Stage，在「Logs/Tracing」里开启「Enable CloudWatch Logs」，设置Log level为INFO。然后去CloudWatch的日志组里找aws/apigateway/API-Gateway-Execution-Logs_{你的API ID}/{Stage名称}，里面会有详细的错误原因，比如“Malformed Lambda proxy response”（就是返回格式不对的典型提示）。

3. 确认API Gateway有调用Lambda的权限 #

有时候API Gateway触发器配置时，权限没有正确添加，导致无法调用Lambda：

• 进入Lambda控制台的触发器页，点击你的API Gateway触发器，查看「Permissions」部分，确认已经存在允许API Gateway调用Lambda的权限策略。
• 如果没有，你可以手动添加权限（替换成你的资源信息）：

aws lambda add-permission \
    --function-name your-function-name \
    --statement-id apigateway-invoke \
    --action lambda:InvokeFunction \
    --principal apigateway.amazonaws.com \
    --source-arn "arn:aws:execute-api:你的区域:你的账号ID:你的API ID/*/GET/你的资源路径"

4. 检查API Gateway的集成设置 #

确保你用的是Lambda代理集成（这是最常用也最不容易出错的方式）：

• 进入API Gateway的GET方法设置，在「Integration Request」里，确认「Lambda Proxy integration」是开启状态。如果没开，要么开启它，要么手动配置集成响应的映射规则（但代理集成更省心）。

5. 注意Lambda事件格式的差异 #

Lambda控制台的测试事件是自定义的，但API Gateway发送的事件包含requestContext、queryStringParameters等字段。如果你的代码依赖于特定的事件字段，可能在API Gateway调用时因为字段不存在报错。建议在代码里做容错处理，比如：

# 示例：获取查询参数时做容错
param = event.get('queryStringParameters', {}).get('param_name', 'default_value')

先从查看日志和修改返回格式开始排查，这两个是最常见的原因！

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