AWS Lambda与API Gateway集成报502错误求助

嘿，我来帮你捋捋这个问题——单独测Lambda正常，走API Gateway就502，日志还显示响应体是null，这种情况我碰到过好几次，大概率是集成环节或者代码里的隐藏问题，咱们一步步排查：

先确认Lambda有没有被API Gateway真正触发 #

首先去CloudWatch的Lambda日志组，找API Gateway调用时间点对应的日志。如果压根找不到Lambda的执行日志，那说明API Gateway和Lambda的集成链路有问题：

• 检查API Gateway的集成权限：如果用的是IAM角色集成，确认角色有lambda:InvokeFunction的权限；如果是Lambda代理集成，看看Lambda的资源策略里有没有允许API Gateway的ARN调用它。
• 核对集成配置里的Lambda ARN有没有写错，别把测试环境的ARN用到生产里了。

检查Lambda代码是否存在未捕获的异常 #

虽然你单独测试没问题，但API Gateway触发的事件结构和本地测试的可能不一样（比如参数位置、请求头差异），说不定触发了代码里的某个异常，导致Lambda没有正常返回响应，API Gateway就拿到了null。
给你的代码加个全局异常捕获和日志输出，这样能立刻看到问题：

import json

def lambda_handler(event, context):
    try:
        # 你的业务逻辑代码
        body = { "message": "Success!!" }
        response = { 
            "statusCode": 200, 
            "headers": { "content-type": "application/json" }, 
            "body": json.dumps(body), 
            "isBase64Encoded": False, 
        }
        # 打印响应日志，方便排查
        print(f"Lambda返回的响应内容: {response}")
        return response
    except Exception as e:
        # 捕获所有异常并打印
        print(f"Lambda执行异常: {str(e)}")
        # 返回标准错误响应
        return {
            "statusCode": 500,
            "body": json.dumps({"error": str(e)}),
            "headers": {"content-type": "application/json"},
            "isBase64Encoded": False
        }

重新部署Lambda后再用API Gateway调用，去看Lambda日志里的异常信息，这通常能直接定位问题。

确认API Gateway集成类型和Lambda返回格式匹配 #

如果你的API Gateway用的是Lambda代理集成（这是最常用的方式），那你现在的返回格式是完全正确的。但如果是非代理集成，Lambda返回的格式就不符合要求了——非代理集成需要Lambda直接返回字符串或者特定结构，API Gateway才能解析，否则就会出现响应体为null的情况。
去API Gateway控制台，进入你的API的「集成请求」，看看有没有勾选「Use Lambda Proxy integration」。如果没勾选，要么改成代理集成（推荐），要么调整Lambda返回格式适配非代理集成（比如直接返回json.dumps(body)而不是嵌套的响应对象）。

检查API Gateway是否部署了最新配置 #

有时候你修改了Lambda代码或者API Gateway集成设置，但忘记重新部署API的阶段了，导致调用的还是旧版本的配置。去API Gateway控制台，进入对应的阶段，点击「Deploy API」重新部署一次，确保所有更新生效。

最后确认序列化是否正常 #

虽然你的测试用例里json.dumps({"message": "Success!!"})没问题，但如果业务逻辑里有不可序列化的对象（比如datetime、自定义类），会导致json.dumps报错，Lambda无法正常返回响应。可以在代码里对序列化步骤单独捕获异常，确保这一步没问题。

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