基于Lambda部署的SpringBoot应用错误映射问题求助

我之前在做SpringBoot+Lambda+API Gateway的项目时，刚好碰到过几乎一模一样的问题！结合我的排查经验，给你几个具体的方向去定位解决：

1. 先确认Lambda环境下的错误输出结构 #

本地测试和Lambda环境的错误返回格式可能不一样，这是导致API Gateway集成响应不生效的核心原因之一：

• 登录Lambda控制台，找到你的函数，进入监控 > 日志，查看当传入无效区域ID时，Lambda实际输出的日志和返回结构。
• 本地测试时SpringBoot可能直接返回标准的错误JSON，但部署到Lambda后，SpringBoot的响应会被Lambda的wrapper（比如Spring Cloud Function的适配器）包装成类似{"statusCode":500,"headers":{},"body":"{\"timestamp\":\"...\",\"message\":\"无效区域ID\"}"}的格式。你需要确认这个结构里的statusCode和body内容，才能匹配API Gateway的集成规则。

2. 检查API Gateway集成响应的匹配规则 #

你的500集成响应没触发，大概率是匹配条件没设置对：

• 进入API Gateway控制台，找到对应的端点，进入集成请求 > 集成响应：
  • 首先看你是否用了Lambda代理集成：如果是代理模式，API Gateway会直接返回Lambda的响应，这时候集成响应的配置不会生效，你需要在SpringBoot里直接返回正确的statusCode和响应体。
  • 如果是非代理模式，要确保Lambda错误正则能匹配到Lambda返回的错误内容。比如如果Lambda返回的body里包含“无效区域ID”，可以把正则设为.*无效区域ID.*；如果是匹配statusCode，要确认Lambda返回的statusCode确实是500。
  • 另外别忘了检查映射模板：比如你要返回自定义响应，需要给application/json类型设置模板，比如{"code":500,"message":"$input.path('$.body.message')"}，这样才能把Lambda的错误信息正确映射到前端。

3. 确保SpringBoot的全局异常处理器在Lambda环境生效 #

如果SpringBoot的异常没被正确捕获，Lambda会抛出未处理的运行时异常，这时候API Gateway会直接返回Amazon的默认错误响应，跳过你的集成配置：

• 检查你的项目是否配置了@RestControllerAdvice全局异常处理器，确保业务异常（比如无效区域ID的异常）被捕获并返回标准的JSON响应：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(InvalidRegionIdException.class)
    public ResponseEntity<ErrorResponse> handleInvalidRegionError(InvalidRegionIdException ex) {
        ErrorResponse error = new ErrorResponse();
        error.setCode(500);
        error.setMessage(ex.getMessage());
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
    }
}

• 还要确认这个处理器在Lambda环境下能正常工作——有时候Lambda的类加载机制和本地不同，可能导致异常处理器没被扫描到，你可以在日志里查看是否有异常被捕获的记录。

4. 重新部署API Gateway阶段 #

有时候你修改了集成响应的配置，但没有重新部署API Gateway的阶段，导致新配置没生效：

• 进入API Gateway的阶段页面，找到你正在使用的阶段，点击部署API，选择最新的API版本重新部署，然后再测试请求。

5. 检查API Gateway的响应头设置 #

如果你收到的错误带有Amazon的响应头，可能是API Gateway默认添加的，你可以在阶段设置 > 响应头里配置自定义的响应头，或者移除不需要的Amazon默认头（比如X-Amzn-Trace-Id这类追踪头，有些情况下是无法移除的，但业务相关的错误头可以自定义）。

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