Spring Boot 3.2.2项目Maven编译报StackOverflowError求助

将Spring 2.X项目升级至Spring Boot 3.2.2，同时把JDK版本从8升级到17（满足Spring Boot 3最低要求）。项目能在Spring Tool Suite 4中正常运行，但命令行执行mvn package war:war编译时抛出java.lang.StackOverflowError。已尝试调整maven-compiler-plugin多种配置、更换Maven版本，均未解决问题。

1. 增大Maven编译时的栈空间 #

栈溢出通常是编译过程中处理复杂依赖、递归逻辑时栈内存不足导致的，直接给Maven进程设置更大的栈大小：

• Linux/macOS终端执行：

  export MAVEN_OPTS="-Xss2m"
  mvn package war:war
  

• Windows命令提示符执行：

  set MAVEN_OPTS=-Xss2m
  mvn package war:war
  

  若2m仍不够，可逐步调整为4m或8m。

2. 给Maven编译插件单独配置栈参数 #

如果maven-compiler-plugin启用了fork模式，需要给子编译进程单独设置栈参数，修改pom.xml中的插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>17</source>
        <target>17</target>
        <fork>true</fork>
        <compilerArgs>
            <arg>-Xss2m</arg>
        </compilerArgs>
    </configuration>
</plugin>

3. 排查代码中的高复杂度逻辑 #

IDE编译通过但Maven命令行失败，可能是IDE的编译缓存或优化策略规避了问题，检查项目中是否存在：

• 深度递归的方法
• 多层嵌套的Spring注解（如嵌套配置类、多层@Bean定义）
• 复杂的类继承/实现链
  这些场景在编译时会消耗更多栈内存，针对性优化代码结构（比如拆解递归、简化注解嵌套）。

4. 清理Maven缓存并重新构建 #

旧的依赖缓存或编译产物可能引发异常，执行以下命令强制清理并重新构建：

mvn clean install -U

内容的提问来源于stack exchange，提问作者FRANCISCO JONATHAN PEREZ PORRA