Agent Skills: Upgrade Spring Boot 3.5.x

Upgrade Spring Boot 3.5.x

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

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