Spring Boot部署AWS Lambda返回502，本地返回500的差异原因

我在控制器中故意编写抛出异常的代码以测试应用故障模式，但本地与AWS部署的结果不一致：

• 本地运行Spring Boot（内嵌Tomcat）调用/api/test/error接口，返回携带Spring Boot默认错误JSON的HTTP 500；
• 在AWS Lambda中通过SpringBootLambdaContainerHandler运行应用，调用同一接口返回仅含通用异常信息的基础JSON的HTTP 502。

请问为何会出现这种差异？

相关代码 #

Controller代码

@RestController
public class TestController {

    @GetMapping("/api/test/error")
    public String error() {
        throw new IllegalStateException("This is a test exception");
    }
}

Lambda请求处理器代码

public class LambdaRequestHandler implements RequestHandler<AwsProxyRequest, AwsProxyResponse> {
    private final static SpringBootLambdaContainerHandler<AwsProxyRequest, AwsProxyResponse> handler;

    static {
        try {
            handler = new SpringBootProxyHandlerBuilder<AwsProxyRequest>()
                    .defaultProxy()
                    .initializationWrapper(new InitializationWrapper())
                    .springBootApplication(MyApplication.class)
                    .servletApplication()
                    .buildAndInitialize();
        } catch (ContainerInitializationException e) {
            e.printStackTrace();
            throw new RuntimeException("Could not initialize Spring Boot application", e);
        }
    }

    @Override
    public AwsProxyResponse handleRequest(AwsProxyRequest input, Context context) {
        return handler.proxy(input, context);
    }
}

问题原因与解释 #

这种差异核心在于运行环境的异常处理链路不同：

1. 本地Tomcat环境：Spring Boot的内嵌Tomcat会集成Spring MVC的DefaultErrorAttributes和BasicErrorController，当控制器抛出未捕获异常时，这套机制会自动捕获异常，生成包含异常详情、请求信息的标准错误JSON，并返回HTTP 500状态码，这是Spring Boot Web应用的默认行为。

2. AWS Lambda + SpringBootLambdaContainerHandler环境：

   • SpringBootLambdaContainerHandler本质是把Lambda请求转换为Servlet请求转发给Spring应用，但它的异常处理逻辑和Tomcat不同。当Spring应用抛出未捕获异常时，Handler可能无法正确将异常转换为符合API Gateway预期的响应格式。
   • HTTP 502状态码是API Gateway返回的，而非Lambda本身。这是因为Lambda返回的响应不符合API Gateway规范（比如响应体格式错误、状态码不合法，或者Lambda执行过程中抛出未处理异常导致响应不完整），API Gateway会判定为"坏网关"，返回502。
   • 另外，SpringBootLambdaContainerHandler默认不会传递Spring Boot的错误详情，而是将异常包装为通用错误响应，再加上Lambda与API Gateway之间的协议转换问题，最终导致返回简化的错误JSON和502状态码。

解决方向 #

• 自定义全局异常处理器：通过@RestControllerAdvice或@ControllerAdvice实现全局异常捕获，手动构造符合要求的响应体和状态码，确保在Lambda环境下返回一致的错误格式。
• 配置异常处理策略：检查AWS Serverless Java Container相关配置，让SpringBootLambdaContainerHandler正确转换Spring的异常响应为AwsProxyResponse。
• 验证Lambda响应格式：确保Lambda返回的AwsProxyResponse包含正确的状态码、响应头和符合JSON规范的响应体，避免API Gateway因格式问题返回502。

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