SpringBoot3部署AWS Lambda：流处理器getAwsProxy触发ClassCastException

我尝试将SpringBoot3应用部署到AWS Lambda，应用在本地运行正常。我使用Gradle/Kotlin构建fatjar并上传至S3，将其作为Lambda函数调用。我的处理器代码如下：

public class LambdaStreamHandler implements RequestStreamHandler {
    private static SpringBootLambdaContainerHandler<AwsProxyRequest, AwsProxyResponse> handler;
    static {
        try {
            System.out.println("initializing LambdaStreamHandler");
            handler = SpringBootLambdaContainerHandler.getAwsProxyHandler(Application.class);
            System.out.println("set hander");
        } catch (ContainerInitializationException e) {
            e.printStackTrace();
            throw new RuntimeException("Could not initialize Spring Boot application", e);
        }
    }

    @Override
    public void handleRequest(InputStream inputStream, OutputStream outputStream, Context context)
            throws IOException {
        System.out.println("Inside of handleRequest...");
        handler.proxyStream(inputStream, outputStream, context);
    }
}

在CloudWatch中看到以下错误日志：

initializing LambdaStreamHandler
...

Error loading class com.my.application.aws.LambdaStreamHandler: java.lang.ExceptionInInitializerError
java.lang.ExceptionInInitializerError
    at java.base/java.lang.Class.forName0(Native Method)
    at java.base/java.lang.Class.forName(Unknown Source)
Caused by: java.lang.ClassCastException: class org.springframework.context.annotation.AnnotationConfigApplicationContext cannot be cast to class org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext (org.springframework.context.annotation.AnnotationConfigApplicationContext and org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext are in unnamed module of loader com.amazonaws.services.lambda.runtime.api.client.CustomerClassLoader @6193b845)
    at com.amazonaws.serverless.proxy.spring.SpringBootLambdaContainerHandler.initialize(SpringBootLambdaContainerHandler.java:191)
    at com.amazonaws.serverless.proxy.InitializationWrapper.start(InitializationWrapper.java:35)
    at com.amazonaws.serverless.proxy.spring.SpringBootProxyHandlerBuilder.buildAndInitialize(SpringBootLambdaContainerHandler.java:79)
    at com.amazonaws.serverless.proxy.spring.SpringBootLambdaContainerHandler.getAwsProxyHandler(SpringBootLambdaContainerHandler.java:87)
    at com.my.application.aws.LambdaStreamHandler.<clinit>(LambdaStreamHandler.java:18)
    ... 2 more

请问有人遇到过此类问题吗？问题原因是什么，该如何解决？我正考虑从Java代理切换至lambda-web-adapter-runner方案。我原本使用该函数作为Spring与Lambda的代理，预期能正常运行，但它似乎需要不同类型的上下文。

原因分析 #

这个ClassCastException的核心问题：

• AWS Lambda的SpringBootLambdaContainerHandler默认期望初始化Servlet类型的Web上下文（AnnotationConfigServletWebServerApplicationContext），但你的Spring Boot 3应用实际初始化了普通非Web上下文（AnnotationConfigApplicationContext），导致类型转换失败。
• 常见触发原因：要么是项目缺少Spring Web相关starter依赖，Spring自动启动了非Web上下文；要么是使用的aws-serverless-java-container版本过低，未适配Spring Boot 3的上下文结构变化。

解决办法 #

1. 检查并添加Web依赖 #

确保build.gradle.kts中包含Spring Boot Web starter：

implementation("org.springframework.boot:spring-boot-starter-web")

如果使用Reactive Web，替换为spring-boot-starter-webflux，同时Lambda处理器要改用对应的Reactive版本（SpringBootReactiveLambdaContainerHandler）。

2. 显式指定Web上下文类 #

如果依赖配置正确，可手动指定上下文类型，避免Spring自动选择非Web上下文：
修改处理器静态块中的初始化代码：

handler = new SpringBootProxyHandlerBuilder<AwsProxyRequest, AwsProxyResponse>()
                .applicationContextClass(AnnotationConfigServletWebServerApplicationContext.class)
                .springBootApplication(Application.class)
                .buildAndInitialize();

3. 升级AWS Lambda Java代理版本 #

确保使用适配Spring Boot 3的代理版本，至少需要2.0.0+（1.x版本仅支持Spring Boot 2.x），更新build.gradle.kts中的依赖：

implementation("com.amazonaws.serverless:aws-serverless-java-container-springboot3:2.0.0")

4. 切换至lambda-web-adapter-runner #

如果上述方案无法解决，lambda-web-adapter-runner确实是更适配Spring Boot 3的方案：

• 无需修改应用代码，直接将Spring Boot fatjar作为Lambda的镜像或层部署；
• 通过适配器将Lambda事件转换为HTTP请求转发给Spring Boot应用，完全贴合本地运行逻辑，从根源避免上下文类型不兼容问题。

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