How to Upgrade Your Spring Boot 3.0 Microservices with Polaris and New Starters

Introduction

PIG, a leading domestic microservice development platform, explores the feasibility of upgrading complex dependency systems to Spring Boot 3.0.

Why Choose Polaris

Polaris, Tencent's open‑source service governance platform, addresses service management, traffic control, configuration, fault tolerance, and observability for distributed microservice architectures. It quickly adapted to Spring Cloud 2022 and Spring Boot 3.0, offering one‑stop microservice governance covering most development scenarios, including Seata for distributed transactions.

Core Dependency Versions

Spring Boot: 3.0.0

Spring Cloud: 2022

Spring Cloud Tencent: 1.8.1

Spring Authorization Server: 1.0.0

What Changed in the 3.0 Upgrade

① Upgrade to Java 17

Spring Boot 3.0 requires at least Java 17; using GraalVM 22.3 is recommended to leverage the native image feature.

② Jakarta EE Migration

Java EE has become Jakarta EE, so packages previously starting with

javax

must be changed to

jakarta

.

③ Automatic Configuration SPI Changes

For example,

mybatis-plus-boot-starter

can no longer use

spring.factories

to import auto‑configuration beans; it must register via

imports

files.

④ Spring Security API Changes

The traditional

WebSecurityConfigurerAdapter

inheritance is removed; security configuration now uses a

SecurityFilterChain

bean.

⑤ Spring Authorization Server Update

Version 1.0 must be used, which introduces breaking changes compared to 0.4.

⑥ springdoc Documentation Update

springdoc 2.0.0 is required for Spring Boot 3.0 compatibility; the UI differs significantly from version 1.0.

Surrounding Ecosystem

Key Spring Boot starters have been upgraded to support the new platform:

multilevel-cache-spring-boot-starter – version 3.0.0

idempotent-spring-boot-starter – version 0.3.0

excel-spring-boot-starter – version 3.0.0

oss-spring-boot-starter – version 3.0.0

aliyun-spring-boot-starter – version 3.0.0

log-trace-spring-boot – version 3.0.0

References

multilevel-cache-spring-boot-starter: https://github.com/pig-mesh/

idempotent-spring-boot-starter: https://github.com/pig-mesh/idempotent-spring-boot-starter

excel-spring-boot-starter: https://github.com/pig-mesh/excel-spring-boot-starter

oss-spring-boot-starter: https://github.com/pig-mesh/oss-spring-boot-starter

aliyun-spring-boot-starter: https://github.com/pig-mesh/aliyun-spring-boot-starter

log-trace-spring-boot: https://github.com/pig-mesh/log-trace-spring-boot