AWS API Gateway集成Lambda(Java)：RequestHandler能否替代RequestStreamHandler？

当然可以！完全不用纠结必须用RequestStreamHandler，用RequestHandler<I, O>（其中I是你的请求POJO，O是响应POJO）完全能实现你想要的效果——API Gateway会自动把客户端发来的JSON反序列化为你的请求POJO，Lambda处理完成后，再把响应POJO序列化为JSON返回给客户端，整个流程非常顺畅。

1. 定义请求/响应POJO #

首先要确保你的POJO满足Jackson（Lambda默认的序列化工具）的要求：要有无参构造函数，字段的getter/setter齐全（嫌麻烦可以用Lombok的@Data注解一键生成）。举个例子：

import lombok.Data;

// 请求POJO，对应客户端发送的JSON结构
@Data
public class UserRequest {
    private String userId;
    private String username;
    private Integer age;
}

// 响应POJO，对应返回给客户端的JSON结构
@Data
public class UserResponse {
    private String status;
    private String message;
    private UserRequest userDetail;
}

2. 实现RequestHandler #

直接实现com.amazonaws.services.lambda.runtime.RequestHandler，泛型参数填你定义的请求和响应POJO即可，代码会比用RequestStreamHandler简洁太多：

import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;

public class UserHandler implements RequestHandler<UserRequest, UserResponse> {

    @Override
    public UserResponse handleRequest(UserRequest input, Context context) {
        // 这里直接用input（已经是反序列化好的POJO）做业务逻辑
        context.getLogger().log("收到用户请求：" + input.getUsername());
        
        // 构造响应POJO
        UserResponse response = new UserResponse();
        response.setStatus("SUCCESS");
        response.setMessage("用户信息处理完成");
        response.setUserDetail(input);
        
        return response;
    }
}

3. API Gateway关键配置 #

很多人尝试失败都是因为这里没配置对，一定要注意：

• 集成类型选择Lambda函数，集成请求的「内容处理」设置为Passthrough（让API Gateway直接把客户端的JSON原封不动传给Lambda）。
• 在方法请求中，确保请求的Content-Type是application/json，响应的Content-Type也设置为application/json。
• 如果是REST API类型，不需要额外添加映射模板（除非你需要修改请求结构），默认模板会把请求体直接传递给Lambda。

如果你之前尝试没成功，大概率是这几个问题：

• POJO没有无参构造函数：Jackson必须用无参构造来实例化对象，一定要加上（Lombok的@Data会自动生成）。
• JSON字段与POJO字段不匹配：客户端发送的JSON字段名要和POJO字段名大小写完全一致，如果不一致可以用@JsonProperty注解指定映射，比如@JsonProperty("user_id") private String userId;。
• 权限配置问题：要确保API Gateway有调用Lambda的权限，Lambda的执行角色也有被API Gateway调用的权限（控制台创建集成时一般会自动配置，手动配置的话要检查IAM策略）。
• 打包问题：打包Lambda代码时，要确保POJO的class文件被包含在JAR包里，依赖（比如Lombok）要正确处理（编译时要让注解生效，打包成可执行JAR）。

这样整个流程就跑通了：客户端发JSON请求 → API Gateway传递给Lambda → Lambda自动反序列化为请求POJO → 业务处理 → 返回响应POJO → Lambda自动序列化为JSON → API Gateway返回给客户端。

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