Spring Data 2026.1

When upgrading to Spring Data 2026.1, refer to the Spring Data 2026.1 Release Notes for newly introduced APIs, deprecated APIs, and breaking changes. Spring Data 2026.1 is the release train for Spring Boot 4.2, and the Spring Boot 4.2 upgrade recipe chains this recipe.

The io.arconia.rewrite.spring.data2026.UpgradeSpringData_2026_1 recipe automates the changes introduced in Spring Data 2026.1. You can use it to update your project to the latest Spring Data 2026.1.x release train.

The recipe will:

  • Upgrade org.springframework.data:spring-data-bom to the 2026.1.x release train, and each Spring Data module to its own release line within that train.

Spring Data 2026.1 removes no public API. Note that Spring Data JPA now fails at startup when the name or countName attribute of @Query references a named query that does not exist, where it used to fall back to a derived query silently.

See its entry in the Recipe Catalog for the full list of recipes this upgrade applies, each with its options and a before/after example.

Run the Recipe

You can apply this recipe with any OpenRewrite-compatible tool. The tabs below show three of them: the Arconia CLI, the OpenRewrite Gradle plugin, and the OpenRewrite Maven plugin. See Running Recipes for a comparison of when to pick each one.

  • Arconia CLI

  • Gradle

  • Maven

arconia rewrite run --recipe-name io.arconia.rewrite.spring.data2026.UpgradeSpringData_2026_1

First, create an init.gradle file in your project root with the following content.

initscript {
    repositories {
        gradlePluginPortal()
    }
    dependencies {
        classpath("org.openrewrite:plugin:latest.release")
    }
}

rootProject {
    plugins.apply(org.openrewrite.gradle.RewritePlugin)
    dependencies {
        rewrite("io.arconia.migrations:rewrite-spring:latest.release")
    }

    // Remove when project repositories are disabled
    afterEvaluate {
        if (repositories.isEmpty()) {
            repositories {
                mavenCentral()
            }
        }
    }

    configurations.named("rewrite") {
        canBeConsumed = false
    }
}

Then, run the following command.

./gradlew rewriteRun \
    --init-script init.gradle \
    --no-parallel \
    -DactiveRecipe=io.arconia.rewrite.spring.data2026.UpgradeSpringData_2026_1

You can remove the init.gradle file afterwards.

./mvnw -U org.openrewrite.maven:rewrite-maven-plugin:run \
  -Drewrite.recipeArtifactCoordinates=io.arconia.migrations:rewrite-spring:LATEST \
  -Drewrite.activeRecipes=io.arconia.rewrite.spring.data2026.UpgradeSpringData_2026_1