How to Seamlessly Upgrade Spring Boot 2.7 for JDK 17 on JD Cloud

1. Introduction

Spring Boot 3.0 requires JDK 17, so the Spring community is dropping JDK 8. Spring Boot 2.7 serves as a transitional release that enables developers to adopt JDK 17 features before moving to 3.0.

2. Why Spring Boot 2.7?

Supports JDK 17 language features such as switch expressions, text blocks, and local variable type inference.

Leverages JDK 17 performance improvements (new garbage collectors, thread scheduling).

Default configuration is compatible with JDK 17, eliminating extra setup.

Improved security by using JDK 17’s enhanced cryptography and TLS defaults.

Memory management and bean handling are optimized compared with earlier 2.x versions.

Using Spring Boot 2.7 therefore maximizes performance, compatibility, and security while minimizing migration pain.

3. Why JDK 17?

JDK 17 introduces new syntax, stronger security controls for reflection and package scanning, and the ZGC garbage collector, which offers sub‑millisecond pause times and high throughput.

3.1 Secure Language Features

Stricter permission checks for reflection (setAccessible control).

Package‑level access control improvements.

Sealed classes and interfaces increase encapsulation.

3.2 Garbage Collector

ZGC on JDK 17 dramatically reduces pause times and improves throughput across all tested hardware configurations.

3.3 OpenJDK 17 Download

Download from Adoptium .

4. JD Cloud Deployment Practices

4.1 Spring Boot 2.7 Maven Setup

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" ...>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.jd.magnus</groupId>
    <artifactId>magnus-multi-ddd</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.17</version>
    </parent>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
</project>

4.2 Dynamic Configuration

Spring Boot 2.7 moves auto‑configuration registration to

META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

and introduces the consolidated @SpringBootApplication annotation.

4.3 Deprecated APIs

SpringBootServletInitializer → SpringBootServletWebServerApplicationContext
ServletWebServerFactoryCustomizer → WebServerFactoryCustomizer
BasicErrorController → ErrorController
...

4.4 Unit Test Upgrade

JUnit 4 is replaced by JUnit Jupiter; test annotations need updating.

4.5 Hibernate‑Validator Dependency

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

4.6 Diagnostic Compatibility Migrator

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

4.7 JD Cloud Image and Build Settings

Use a base image that includes OpenJDK 17, e.g., base_tomcat/java-jd-centos7-jdk17-tomcat8.5.42-ngx197:latest. Choose Maven 3.9.0 for best JDK 17 compatibility.

4.8 JVM Parameters (example for 4C8G)

-Xms5324m -Xmx5324m -XX:MaxMetaspaceSize=256m -XX:MetaspaceSize=256m 
-XX:MaxDirectMemorySize=983m -Djava.library.path=/usr/local/lib -server 
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/export/Logs 
-Djava.awt.headless=true -Dsun.net.client.defaultConnectTimeout=60000 
-Dsun.net.client.defaultReadTimeout=60000 -Djmagick.systemclassloader=no 
-Dnetworkaddress.cache.ttl=300 -Dsun.net.inetaddr.ttl=300 -XX:+UseZGC

Do not set parallel GC thread counts when using ZGC.

4.9 Compatibility Flags

--add-opens java.base/sun.security.action=ALL-UNNAMED
--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.base/java.util=ALL-UNNAMED
... (other modules)

Specific flags are required for SGM, R2M, DUCC, AKS, Pfinder, and Swagger compatibility.

5. Scaffold Support

The DDD scaffold now supports Spring Boot 2.7.17 and JDK 17. Generate a project with:

mvn archetype:generate \
    -DarchetypeGroupId=com.jd.magnus \
    -DarchetypeArtifactId=magnus-multi-ddd-archetype \
    -DarchetypeVersion=1.0.0-SNAPSHOT \
    -DinteractiveMode=false \
    -DarchetypeCatalog=remote \
    -Dversion=1.0.0-SNAPSHOT \
    -DgroupId=com.jdl.sps \
    -DartifactId=bff-demo1

6. IDE Configuration Tips

Install JDK 17 in IntelliJ IDEA and set the project SDK and language level accordingly. Optionally install the JDK 17 plugin.

When debugging, add the compatibility --add-opens flags to the VM options. The same flags should be added to Maven Surefire plugin configuration for test execution.

7. Conclusion

Pilot projects (JD Flag API, BFF shipping platform, logistics service) have successfully run on JD Cloud with JDK 17 + Spring Boot 2.7, showing good compatibility with internal dependencies such as JSF lite, DUCC, EasyJob, JMQ, cloud Redis, UMP, and Pfinder. Future upgrades to Spring Boot 3.0 are planned as the ecosystem matures.