springmvc+jdk1.8升级到springboot3+jdk17（实战）

1.查找springboot3官方要求

这里查的是springboot 3.2.6版本的

2.升级jdk到17

Java EE 8之后，Oracle在19年把javax捐给了eclipse基会，但不允许使用javax的命名空间，所以eclipse才发展成为现在的Jakarta ee标准。Springboot3后使用Jakarta api，要求servlet6.0及以上，javax*的接口都无法使用报红。

所以依赖加入以下包：

<dependency>
   <groupId>jakarta.annotation</groupId>
   <artifactId>jakarta.annotation-api</artifactId>
   <version>2.1.1</version>
</dependency>
<dependency>
   <groupId>org.projectlombok</groupId>
   <artifactId>lombok</artifactId>
   <version>1.18.30</version>
</dependency>
<dependency>
   <groupId>jakarta.servlet</groupId>
   <artifactId>jakarta.servlet-api</artifactId>
   <version>6.0.0</version>
</dependency>

代码中：

所有resouce替换成import jakarta.annotation.Resource;

所有PostConstruct替换成import jakarta.annotation.PostConstruct;

所有servlet、filter相关javax的都需要重新导成jakarta下的包。

Base64修改：

BASE64Encoder encoder = new BASE64Encoder();

return encoder.encode(data);

改为：

Base64.Encoder encoder = Base64.getEncoder();

return encoder.encodeToString(data);

3.springboot升级 

3.1 版本引入

参考Using the Plugin :: Spring Boot

3.2 相关包升级

之前所有的spring相关包版本升级到对应的6.1.6

groovy-all也需要升级：

<dependency>
   <groupId>org.codehaus.groovy</groupId>
   <artifactId>groovy-all</artifactId>
   <version>3.0.7</version>
</dependency>

这里有个坑，大家需要注意，如果你没使用spring的parent，升级到了3.2.5。需要在pom maven-compiler-plugin中加入parameters，否则参数地址都是访问不了。这是因为LocalVariableTableParameterNameDiscoverer已在 6.1 中删除。因此，Spring 框架和 Spring 组合框架中的代码不再尝试通过解析字节码来推断参数名称。如果您遇到依赖项注入、属性绑定、SpEL 表达式或其他依赖于参数名称的用例的问题，则应使用通用 Java 8+ 标志-parameters来保留参数名称来编译 Java 源代码（而不是依赖于-debug编译器）标志）以便与StandardReflectionParameterNameDiscoverer. Groovy 编译器还支持-parameters用于相同目的的标志。对于 Kotlin 编译器，请使用该-java-parameters标志。

<plugin>

   <groupId>org.apache.maven.plugins</groupId>

   <artifactId>${maven_compiler_plugin_version}</artifactId>

   <version>3.11.0</version>

   <configuration>

      <parameters>true</parameters>

      <source>17</source>

      <target>17</target>

      <compilerArgs>

         <arg>-Xlint:deprecation</arg>

         <arg>-Xlint:options</arg>

         <arg>-Xlint:path</arg>

         <arg>-Xlint:unchecked</arg>

      </compilerArgs>

      <forceJavacCompilerUse>true</forceJavacCompilerUse>

   </configuration>

</plugin>

3.3 升级后编译问题

HandlerInterceptorAdapter在springboot3中已经移除，所有Interceptor原来继承HandlerInterceptorAdapter，都改为实现HandlerInterceptor接口。

3.4 web.xml转换

springboot没有web.xml配置，需要把web.xml中监听器、过滤器、servlet等转换为springboot configBean形式。

3.5 spring xml转换

如果引用的第三方包jar中有xml初始：

可以不用改动，直接加如下初始：

@Configuration
@ImportResource(locations = {"classpath*:/test.xml"})
public class SpringxmlConfig {


}

如果项目中配置可以依次转为config bean形式。 

3.6 如果原有工程有循环依赖启用循环依赖

springboot2.6禁用了循环依赖，如果代码工程中有，需要开启，yml配置：

spring:
  main:
    #springboot从2.6之后默认禁用了循环依赖，由于项目中有循坏依赖，故开启
    allow-circular-references: true