如何在本地启动基于Java的AWS Lambda Maven项目？

必备额外工具 #

• AWS SAM CLI：这是本地运行、调试Lambda的核心工具，必须安装。安装完成后，在终端执行 sam --version 验证是否安装成功。

本地运行流程 #

1. 检查项目Maven配置 #

确认每个Lambda项目的pom.xml中已配置AWS Lambda打包插件，没有的话添加以下内容：

<build>
    <plugins>
        <plugin>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-lambda-java-plugin</artifactId>
            <version>1.2.21</version>
            <executions>
                <execution>
                    <goals>
                        <goal>package</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

这个插件会帮你打包包含所有依赖的"胖JAR"，是SAM本地运行必需的包格式。

2. 构建Lambda包 #

进入项目根目录，执行Maven打包命令：
mvn clean package
打包完成后，target目录下会生成类似xxx-jar-with-dependencies.jar的文件，这就是我们需要的运行包。

3. 配置SAM模板（无模板时初始化） #

如果项目里没有template.yaml（SAM的部署模板），在项目根目录执行：
sam init
选择Java作为运行时，跟着向导生成基础模板。之后修改模板中的CodeUri指向刚才生成的JAR包路径，同时确认Handler和Runtime配置正确：

Resources:
  YourLambdaFunc:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: target/your-lambda-package.jar
      Handler: com.yourteam.YourLambdaHandler::handleRequest # 替换成你的处理类和方法
      Runtime: java17 # 匹配云端Lambda的运行时版本

4. 启动本地Lambda #

• 如果是API Gateway触发的Lambda，执行：
  sam local start-api
  启动后控制台会输出本地API地址，直接用curl或Postman访问即可测试。
• 如果是直接触发的Lambda，执行：
  sam local invoke YourLambdaFunc
  需要传递测试事件的话，用：
  sam local invoke YourLambdaFunc -e event.json
event.json是你模拟的触发事件文件，比如S3上传事件、自定义JSON事件等。

注意事项 #

• 本地JDK版本必须和云端Lambda的运行时版本完全一致，避免出现兼容性错误。
• 如果Lambda依赖AWS云服务（如S3、DynamoDB），本地可使用LocalStack模拟这些服务，或者直接调用云端的测试环境实例。
• 若打包时出现依赖冲突，检查pom.xml中的依赖范围，排除重复或不必要的依赖。

内容的提问来源于stack exchange，提问作者Félix Mensah