AWS Lambda平台Spring Cloud Function用@ExceptionHandler全局异常处理失效问题

根因说明 #

@ExceptionHandler是Spring Web MVC/WebFlux面向Controller层提供的异常处理能力，你当前将注解直接写在启动类中，且Spring Cloud Function部署在AWS Lambda环境时默认调用链路未加载Spring Web的异常处理切面，因此该方法不会被触发，所有未捕获异常会被Lambda适配器默认封装为500错误返回。

可行解决方案 #

方案1：使用@RestControllerAdvice实现全局异常处理（推荐，适配带Web依赖的场景） #

如果你引入了spring-cloud-function-web依赖，只需要将异常处理逻辑抽至带@RestControllerAdvice注解的独立类中，即可被Spring全局扫描并生效：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ResponseStatusException.class)
    public APIGatewayProxyResponseEvent handleResponseStatusException(ResponseStatusException e) {
        APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent();
        response.setStatusCode(e.getRawStatusCode());
        response.setBody(e.getReason());
        // 可按需添加响应头配置
        return response;
    }

    // 可扩展其他异常类型的处理逻辑
    @ExceptionHandler(Exception.class)
    public APIGatewayProxyResponseEvent handleGenericException(Exception e) {
        APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent();
        response.setStatusCode(500);
        response.setBody("Internal server error");
        return response;
    }
}

方案2：使用FunctionAroundAdvice环绕拦截处理（无Web依赖场景通用） #

如果你的项目未引入Web相关依赖，可以通过Spring Cloud Function提供的函数环绕通知，统一拦截所有函数执行逻辑，捕获异常后自定义返回：

@Component
public class GlobalFunctionExceptionAdvice implements FunctionAroundAdvice {
    @Override
    public Object around(FunctionInvocation invocation) throws Throwable {
        try {
            // 执行原函数逻辑
            return invocation.proceed();
        } catch (ResponseStatusException e) {
            APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent();
            response.setStatusCode(e.getRawStatusCode());
            response.setBody(e.getReason());
            return response;
        } catch (Exception e) {
            APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent();
            response.setStatusCode(500);
            response.setBody("System internal error");
            return response;
        }
    }
}

方案3：自定义RequestHandler入口手动捕获 #

如果你是直接实现AWS的RequestHandler作为函数入口，可以在调用逻辑外层手动捕获异常：

public class UserFunctionHandler implements RequestHandler<Message<User>, Object> {
    private final ApplicationContext context = new SpringApplicationBuilder(App.class).run();
    private final Function<Message<User>, User> getUserFunction = context.getBean("getUser", Function.class);

    @Override
    public Object handleRequest(Message<User> input, Context lambdaContext) {
        try {
            return getUserFunction.apply(input);
        } catch (ResponseStatusException e) {
            APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent();
            response.setStatusCode(e.getRawStatusCode());
            response.setBody(e.getReason());
            return response;
        }
    }
}

注意事项 #

• 确保异常处理逻辑的返回类型和AWS Lambda触发器要求的返回格式匹配，若触发器对接API Gateway，必须返回APIGatewayProxyResponseEvent类型才能被正确识别状态码和响应体。
• 若函数原本定义的返回类型为特定业务类，可将函数返回值改为Object类型兼容正常响应和异常响应。

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