AWS API Gateway路径参数在Java应用中触发空指针异常

排查与修复步骤 #

• 检查API Gateway资源配置
  确认/ticket-order/{email}资源的路径参数email已正确定义：

  1. 进入API Gateway控制台，找到对应API和dev阶段
  2. 定位到/ticket-order下的{email}资源，查看资源详情的路径参数列表是否包含email
  3. 确认GET方法的请求设置中，路径参数已启用

• 修正集成请求的映射模板
  如果你用的是Lambda代理集成（Java Lambda用APIGatewayProxyRequestEvent的常规场景），API Gateway会自动封装所有请求参数到事件对象中，不需要手动配置映射模板——自定义模板反而会覆盖默认逻辑，导致pathParameters为空。

  注意：仅非代理集成才需要手动写映射模板，代理集成保留默认配置即可。
  检查步骤：

  1. 进入GET方法的集成请求设置
  2. 确认是否勾选了使用Lambda代理集成
  3. 若勾选，直接删除自定义映射模板

• 验证Lambda函数的依赖与代码
  确保正确引入AWS Lambda事件依赖，且入口方法参数为APIGatewayProxyRequestEvent：

  import com.amazonaws.services.lambda.runtime.Context;
  import com.amazonaws.services.lambda.runtime.RequestHandler;
  import com.amazonaws.services.lambda.runtime.events.APIGatewayProxyRequestEvent;
  import com.amazonaws.services.lambda.runtime.events.APIGatewayProxyResponseEvent;
  
  public class TicketOrderHandler implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
      @Override
      public APIGatewayProxyResponseEvent handleRequest(APIGatewayProxyRequestEvent input, Context context) {
          // 先做非空判断避免NPE
          if (input.getPathParameters() == null || !input.getPathParameters().containsKey("email")) {
              return new APIGatewayProxyResponseEvent().withStatusCode(400).withBody("Missing email parameter");
          }
          String email = input.getPathParameters().get("email");
          // 后续业务逻辑
          return new APIGatewayProxyResponseEvent().withStatusCode(200).withBody("Processed order for: " + email);
      }
  }
  

  Maven依赖示例（使用最新稳定版）：

  <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-lambda-java-events</artifactId>
      <version>3.11.0</version>
  </dependency>
  

• 重新部署API阶段
  修改配置后必须重新部署API到dev阶段，否则新配置不会生效：

  1. 在API Gateway控制台点击部署API
  2. 选择dev阶段完成部署后，再用Postman测试

快速排查技巧 #

在Lambda函数中打印完整请求事件，确认参数是否真的未传入：

context.getLogger().log("Full request event: " + input.toString());

如果日志中pathParameters为空，问题出在API Gateway配置；如果参数存在，就是代码未做非空判断导致的NPE。

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