如何处理APIGatewayProxyRequestEvent请求体？解决字段缺失异常

问题现状 #

当前代码在请求体包含name字段时可正常执行，但当请求体传入fullName而非name时，调用jsonObject.getString("name")会抛出异常，无法进入else分支处理fullName场景——这是因为JSONObject.getString()方法在目标字段不存在时会直接抛出JSONException，而非返回null或空字符串。

解决方案 #

以下是几种实用的处理方式，按推荐程度排序：

1. 使用optString方法（最简便）

JSONObject提供的optString()方法会在字段不存在时返回指定默认值，不会抛出异常，完美适配你的场景：

public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent event, final Context context) {
    String requestString = event.getBody();
    JSONObject jsonObject = new JSONObject(requestString);
    
    String name = jsonObject.optString("name", "");
    if (!Strings.isNullOrEmpty(name)) {
        // 处理name字段的业务逻辑
    } else {
        String fullName = jsonObject.optString("fullName", "");
        if (!Strings.isNullOrEmpty(fullName)) {
            // 处理fullName字段的业务逻辑
        }
    }
}

optString(key, defaultValue)中第二个参数为字段不存在时的默认值，这里设为空字符串，配合Strings.isNullOrEmpty()即可正常判断两种场景。

2. 先判断字段是否存在

如果倾向于显式检查字段存在性，可以先用has()方法验证字段是否存在，再调用getString()：

public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent event, final Context context) {
    String requestString = event.getBody();
    JSONObject jsonObject = new JSONObject(requestString);
    
    if (jsonObject.has("name") && !Strings.isNullOrEmpty(jsonObject.getString("name"))) {
        // 处理name字段的业务逻辑
    } else if (jsonObject.has("fullName") && !Strings.isNullOrEmpty(jsonObject.getString("fullName"))) {
        // 处理fullName字段的业务逻辑
    }
}

has(key)会先确认字段存在，避免了字段缺失时的异常抛出。

3. 进阶：用实体类+JSON序列化框架（更易维护）

若请求体结构复杂或后续有扩展需求，推荐定义实体类配合Jackson等序列化框架处理，代码可读性和可维护性更高：

首先定义请求实体类：

public class UserRequest {
    private String name;
    private String fullName;
    private Integer age;
    
    // 生成getter和setter方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getFullName() { return fullName; }
    public void setFullName(String fullName) { this.fullName = fullName; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
}

然后修改handler代码：

import com.fasterxml.jackson.databind.ObjectMapper;

public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent event, final Context context) {
    ObjectMapper objectMapper = new ObjectMapper();
    try {
        UserRequest userRequest = objectMapper.readValue(event.getBody(), UserRequest.class);
        
        if (!Strings.isNullOrEmpty(userRequest.getName())) {
            // 处理name字段的业务逻辑
        } else if (!Strings.isNullOrEmpty(userRequest.getFullName())) {
            // 处理fullName字段的业务逻辑
        }
    } catch (Exception e) {
        // 捕获JSON解析异常，返回错误响应
        return new APIGatewayProxyResponseEvent().withStatusCode(400).withBody("Invalid request body");
    }
    
    // 返回正常响应
    return new APIGatewayProxyResponseEvent().withStatusCode(200);
}

Jackson在解析时，不存在的字段会被设为null，不会抛出异常，同时实体类让请求结构一目了然，后续扩展字段只需修改实体类即可。

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