Spring Boot 3.5.x Upgrade

Upgrade Java services to Spring Boot 3.5.9 with all required dependency updates.

When to Use

• Project uses Spring Boot 3.4.x or earlier
• Preparing for Spring Boot 4 (stay on latest or latest-1 patch of 3.5.x)
• Need features from Spring Boot 3.5.x
• Preparing for Java 25 upgrade (requires Spring Boot 3.5.x first)
• When asked to "upgrade to recommended versions"

Skill Contents

Sections

• When to Use
• Target Versions
• Version Unification
• Quick Start
• References
• Related Command
• Related Skills

Available Resources

📚 references/ - Detailed documentation

• troubleshooting

---

Target Versions

Component	Version	Notes
Spring Boot	3.5.9	Latest (min 3.5.9) - preparing for Spring Boot 4
Spring Cloud	2025.0.0	Required for Spring Boot 3.5.x
Spring Dependency Management	1.1.7	Required plugin version
Gradle	9.2.1	Recommended for all projects
JUnit	5.14.2	Testing (via BOM)
Spock	2.4-groovy-4.0	Groovy testing (use -groovy-5.0 for Java 25)
JaCoCo	0.8.14	Code coverage
SonarQube Plugin	7.2.2.6593	Code analysis
bitso-rds-iam-authn	2.0.0	If using RDS IAM
bitso-commons-redis	4.2.1	If using Redis

Version Unification

CRITICAL: Ensure Spring Boot version is defined in only ONE place.

See version-centralization.md for details on avoiding multiple version definitions.

Quick Start

1. Update Version Catalog

# gradle/libs.versions.toml
[versions]
springBoot = "3.5.9"
springCloud = "2025.0.0"  # CRITICAL for 3.5.x compatibility
spock = "2.4-groovy-4.0"

[plugins]
spring-boot = { id = "org.springframework.boot", version.ref = "springBoot" }
spring-dependency-management = { id = "io.spring.dependency-management", version = "1.1.7" }

2. Update Gradle Wrapper

./gradlew wrapper --gradle-version=9.2.1

3. Add JUnit Platform Launcher

Required for Gradle 9.x with JUnit 5.11+:

subprojects {
    plugins.withType(JavaPlugin).configureEach {
        dependencies {
            testRuntimeOnly libs.junit.platform.launcher
        }
    }
}

4. Update Redis Libraries (if applicable)

Check if project uses Redis:

grep -r "bitso.commons:redis\|jedis" --include="*.gradle" --include="*.toml" .

If Redis is used, update:

[versions]
bitso-commons-redis = "4.2.1"
jedis4-utils = "3.0.0"

5. Validate

./gradlew clean build -x test
./gradlew test

References

Reference	Content
references/troubleshooting.md	Common issues and solutions

Related Command

This skill is referenced by: /upgrade-to-recommended-versions (see java/commands/)

Related Skills

The following skills in this category depend on Spring Boot 3.5.x:

• java-25 - Java 25 upgrade (requires Spring Boot 3.5.x first)
• gradle-9 - Gradle 9 upgrade patterns