Spring Boot应用部署至AWS Lambda无法启动问题求助

我之前把Spring Boot应用部署到Lambda时也碰到过一模一样的问题，这个异常本质是Spring的Web上下文没有被正确初始化，导致SpringBootLambdaContainerHandler无法找到它。下面是几个我亲测有效的解决思路：

1. 检查Lambda入口类的初始化逻辑 #

Lambda的入口类必须用静态块初始化SpringBootLambdaContainerHandler，因为Lambda运行时会复用容器实例，静态块只会执行一次，避免重复初始化上下文。正确的写法应该是这样：

import com.amazonaws.serverless.proxy.model.AwsProxyRequest;
import com.amazonaws.serverless.proxy.model.AwsProxyResponse;
import com.amazonaws.serverless.proxy.spring.SpringBootLambdaContainerHandler;
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;

public class SpringBootLambdaHandler implements RequestHandler<AwsProxyRequest, AwsProxyResponse> {
    // 静态初始化handler，确保只执行一次
    private static final SpringBootLambdaContainerHandler<AwsProxyRequest, AwsProxyResponse> handler;

    static {
        try {
            // 传入你的Spring Boot主应用类
            handler = SpringBootLambdaContainerHandler.getAwsProxyHandler(YourSpringBootApplication.class);
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException("Failed to initialize Spring Boot Lambda handler", e);
        }
    }

    @Override
    public AwsProxyResponse handleRequest(AwsProxyRequest input, Context context) {
        // 委托给handler处理请求
        return handler.proxy(input, context);
    }
}

不要在handleRequest方法里初始化handler，否则每次请求都会尝试创建新的上下文，大概率会触发这个异常。

2. 确保依赖版本兼容 #

aws-serverless-java-container的版本要和你的Spring Boot版本严格对应：

• 如果用Spring Boot 2.x，必须引入aws-serverless-java-container-springboot2依赖
• 如果用Spring Boot 3.x，要使用适配的2.x系列aws-serverless-java-container依赖

举个Maven依赖的例子（Spring Boot 2.x场景）：

<dependency>
    <groupId>com.amazonaws.serverless</groupId>
    <artifactId>aws-serverless-java-container-springboot2</artifactId>
    <version>1.9.2</version> <!-- 建议使用最新的兼容稳定版 -->
</dependency>

如果依赖版本不匹配，容器工具类无法正确识别Spring Boot的上下文结构，就会抛出找不到上下文的异常。

3. 检查Spring Boot主类的配置 #

你的Spring Boot主类必须带有@SpringBootApplication注解，并且不要手动初始化WebApplicationContext：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class YourSpringBootApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourSpringBootApplication.class, args);
    }
}

Lambda容器会自动通过主类初始化上下文，不需要你额外编写上下文创建逻辑。

4. 验证打包方式 #

确保打包时包含了所有必要的依赖，推荐使用maven-shade-plugin来构建符合Lambda要求的JAR包，配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <configuration>
                <createDependencyReducedPom>false</createDependencyReducedPom>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

避免使用Spring Boot的spring-boot-maven-plugin打包成可执行JAR，因为它的结构和Lambda要求的JAR结构有差异，可能导致类加载问题。

本地调试排查 #

如果还是有问题，可以用AWS SAM CLI在本地模拟Lambda环境运行你的代码，这样能快速定位问题：

sam local invoke "YourLambdaFunction" -e event.json

通过本地日志可以更清晰地看到上下文初始化的详细过程，找到具体的失败原因。

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