如何让Maven自动构建Java项目以实现Localstack热重载？

一、Maven自动构建热重载目录结构 #

通过组合Maven核心插件，自动生成Localstack热重载要求的目录结构，无需手动解压zip包。在pom.xml中添加以下插件配置：

1. 编译源码到目标目录

配置maven-compiler-plugin将编译后的类文件输出到target/hot-reload/com目录：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.12.1</version>
    <configuration>
        <source>21</source>
        <target>21</target>
        <outputDirectory>${project.build.directory}/hot-reload/com</outputDirectory>
    </configuration>
</plugin>

2. 复制依赖到lib目录

使用maven-dependency-plugin将项目依赖提取到target/hot-reload/lib，可排除AWS Lambda runtime自带的依赖以减少冗余：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.1</version>
    <executions>
        <execution>
            <id>copy-dependencies</id>
            <phase>package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/hot-reload/lib</outputDirectory>
                <excludeGroupIds>com.amazonaws</excludeGroupIds>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 复制资源文件

用maven-resources-plugin将src/main/resources下的配置文件（如application.yml）复制到热重载根目录：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <executions>
        <execution>
            <id>copy-resources</id>
            <phase>package</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/hot-reload</outputDirectory>
                <resources>
                    <resource>
                        <directory>src/main/resources</directory>
                        <includes>
                            <include>application.yml</include>
                        </includes>
                    </resource>
                </resources>
            </configuration>
        </execution>
    </executions>
</plugin>

执行./mvnw package后，target/hot-reload会自动生成所需结构：

target/hot-reload/
com/
lib/
application.yml

二、实现源码监听与自动重建 #

使用maven-watch-plugin监听源码和资源文件变化，自动触发构建任务，实现热重载：

1. 添加监听插件配置

在pom.xml中加入：

<plugin>
    <groupId>com.github.goldin</groupId>
    <artifactId>maven-watch-plugin</artifactId>
    <version>1.1.0</version>
    <configuration>
        <directories>
            <directory>src/main/java</directory>
            <directory>src/main/resources</directory>
        </directories>
        <includes>
            <include>**/*.java</include>
            <include>**/*.yml</include>
        </includes>
        <goals>
            <goal>package</goal>
        </goals>
        <quiet>false</quiet>
    </configuration>
</plugin>

2. 自定义快捷调用任务

在pom.xml中添加自定义执行目标，方便快速启动监听：

<plugin>
    <artifactId>maven-exec-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>runWatchAndLiveReload</id>
            <goals>
                <goal>exec</goal>
            </goals>
            <configuration>
                <executable>./mvnw</executable>
                <arguments>
                    <argument>watch:watch</argument>
                </arguments>
            </configuration>
        </execution>
    </executions>
</plugin>

执行./mvnw exec:exec@runWatchAndLiveReload后，Maven会自动监听源码和配置文件变化，实时重建并更新target/hot-reload目录，Localstack会自动检测变更并重载Lambda函数。

三、SAM模板配置 #

将SAM模板中的CodeUri指向生成的热重载目录（替换为你的项目绝对路径）：

SpringBootLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      FunctionName: SpringBootAPIHandler
      Handler: com.javatechie.StreamLambdaHandler::handleRequest
      Runtime: java21
      CodeUri:
        Bucket: hot-reload
        Key: /path/to/your/project/target/hot-reload

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