Upgrade to Gradle 9.3.1 and Micronaut 4 #15365

jamesfredley · 2026-01-30T15:24:01Z

Summary

This PR upgrades the Grails build infrastructure to use Gradle 9.3.1 and upgrades the grails-forge module to Micronaut 4.

Changes

Gradle 9.3.1 Upgrade

Update Gradle wrapper from 8.14.4 to 9.3.1 across all modules
Fix deprecated Gradle APIs:
- Replace convention with extensions API
- Replace ConfigureUtil with ClosureBackedAction
- Replace JavaPluginConvention with JavaPluginExtension
- Replace outputFile with destinationFile in WriteProperties
Add JUnit Platform launcher dependency required by Gradle 9 for test execution
Update .sdkmanrc to reference Gradle 9.3.1

Develocity Plugin Update

Update com.gradle.develocity from 4.1.1 to 4.3.2 (latest compatible with Develocity 2025.4.2)
Update com.gradle.common-custom-user-data-gradle-plugin from 2.3 to 2.4.0
Migrate grails-data-neo4j and grails-data-graphql from deprecated gradle-enterprise plugin to develocity
Add reproducible build configuration to grails-data-neo4j and grails-data-graphql settings

Task.project Deprecation Fixes

Fix deprecated Task.project access at execution time (scheduled for removal in Gradle 10) by capturing project properties at configuration time:

SbomPlugin: Capture projectName, projectPath, and buildDate at configuration time; refactor pickLicense() to accept these values instead of task reference
PublishPlugin: Capture PublishingExtension at configuration time before doLast block
GrailsGradlePlugin: Capture buildDir at configuration time for buildProperties task; capture antBuilder at configuration time for native2ascii task
GrailsProfileGradlePlugin: Replace project.sync in doLast with proper Sync task type

Micronaut 4 Upgrade (grails-forge)

Upgrade Micronaut from 3.10.4 to 4.10.7
Upgrade Groovy from 3.x to 4.0.30
Upgrade Spock from 2.1-groovy-3.0 to 2.3-groovy-4.0
Migrate javax.* to jakarta.* validation annotations:
- javax.validation.constraints.* → jakarta.validation.constraints.*
- javax.transaction.* → jakarta.transaction.*
Update dependency coordinates:
- org.codehaus.groovy → org.apache.groovy
- io.micronaut:micronaut-bom → io.micronaut.platform:micronaut-platform
- javax.inject:javax.inject → jakarta.inject:jakarta.inject-api
Add micronaut-validation-processor for annotation processing
Add micronaut-jackson-databind runtime dependency
Add @Validated annotation to controllers using validation
Remove explicit shadow plugin (now provided by micronaut-application plugin)

Test Infrastructure Updates

Add ByteBuddy dependency for Spock mocking on Java 17+ (CGLIB doesn't support Java 17 class files)
Add --add-opens java.base/java.lang=ALL-UNNAMED JVM arg for test execution
Update Coherence BOM license mapping for version 25.03.2

Testing

Application Testing

grails-forge-web-netty starts successfully and displays Micronaut 4 banner
Application starts on configured port

Plugin Output Verification

Verified output before/after Task.project deprecation fixes:

Plugin	Task	Result
SbomPlugin	`cyclonedxBom`	✅ Identical (except expected timestamp/UUID differences)
PublishPlugin	`savePublishedArtifacts`	✅ Identical
GrailsProfileGradlePlugin	`processProfileResources`	✅ Identical
GrailsGradlePlugin	`buildProperties`	✅ Functionally identical (minor formatting: one less blank line from switching Ant to Java Properties API)
grails-doc	`docs`	✅ Identical (`ref/Versions/Grails BOM.html` verified)

Known Deprecation Warnings

The following deprecation warning remains (scheduled for Gradle 10, not blocking):

StartParameter.isConfigurationCacheRequested from org.asciidoctor.jvm.convert plugin (4.0.5)
- Fix available in asciidoctor-gradle-plugin 5.0.0+ (currently alpha)
- Tracking: Checklist for 5.0.0-alpha.1 release. asciidoctor/asciidoctor-gradle-plugin#756

@Inject

- Update Gradle wrapper to 9.3.1 across grails-core, grails-gradle, build-logic, and profiles - Migrate Groovy dependencies from org.codehaus.groovy to org.apache.groovy (Groovy 4+) - Update Spock version for grails-gradle tests to 2.3-groovy-4.0 - Add explicit groovy.ant.AntBuilder import (moved in Groovy 4) - Make task classes abstract for Gradle 9 compatibility (JavaExec, AbstractCompile) - Add @Inject annotation to task constructors where required - Fix documentation configuration attributes for groovydoc tasks - Update IOUtilsSpec test expectation for Groovy 4 Spock jar name Note: grails-forge remains on Gradle 8.x pending Micronaut 4 upgrade

- Upgrade Micronaut from 3.10.4 to 4.10.7 - Upgrade Groovy from 3.x to 4.0.30 - Upgrade Spock from 2.1-groovy-3.0 to 2.3-groovy-4.0 - Migrate javax.* to jakarta.* validation annotations - Update dependency coordinates from org.codehaus.groovy to org.apache.groovy - Update micronaut-bom to micronaut-platform - Add micronaut-validation-processor for annotation processing - Add micronaut-jackson-databind runtime dependency - Fix deprecated Gradle APIs (conventions -> extensions) - Add ByteBuddy for Spock mocking on Java 17+ - Add JUnit Platform launcher for Gradle 9 test execution - Remove shadow plugin (now provided by micronaut-application plugin)

jdaugherty · 2026-01-30T15:27:33Z

@jamesfredley did Gradle 9 not remove the testClassDir as they said they would? It was my understanding the integration plugin + TCK had to be rewritten similar to the grails-publish project to work.

jdaugherty · 2026-01-30T15:28:56Z

The SBOM plugin needs updated as part of upgrading to Gradle 9.
How are you working around the configuration cache? Are you just disabling it? It's my understanding plugins like asciidoctor cause issues with it unless you disable. If we update, it should work.

Replace artifacts { archives ... } with direct task dependencies on assemble task as recommended by Gradle 9 deprecation warnings. The remaining StartParameter.isConfigurationCacheRequested deprecation is from the Asciidoctor Gradle plugin (grolifant library) and cannot be fixed in this project.

Copilot

Pull request overview

Upgrades the build/tooling stack to Gradle 9.3.1 and updates the grails-forge module family to Micronaut 4 / Groovy 4 / Spock 2.3, including related Gradle API migrations and test-runtime adjustments.

Changes:

Bump Gradle wrapper/tooling versions to 9.3.1 across the repo and update Gradle plugin/task implementations for Gradle 9 APIs.
Upgrade grails-forge to Micronaut 4 (Groovy 4, Spock 2.3) and migrate javax.* validation/transaction usage to jakarta.*.
Update test infrastructure for Gradle 9 / Java 17+ (JUnit Platform launcher, Byte Buddy, and JVM --add-opens).

Reviewed changes

Copilot reviewed 55 out of 55 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
grails-profiles/profile/skeleton/gradle/wrapper/gradle-wrapper.properties	Update profile skeleton Gradle wrapper to 9.3.1
grails-profiles/base/skeleton/gradle/wrapper/gradle-wrapper.properties	Update base skeleton Gradle wrapper to 9.3.1
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/views/markup/MarkupViewCompilerTask.groovy	Make task type abstract for Gradle 9 task instantiation model
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/views/json/GsonViewCompilerTask.groovy	Make task type abstract for Gradle 9 task instantiation model
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/run/GrailsRunTask.groovy	Make task type abstract for Gradle 9 task instantiation model
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/profiles/tasks/ProfileCompilerTask.groovy	Make task type abstract for Gradle 9 task instantiation model
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/commands/ApplicationContextScriptTask.groovy	Make task abstract and add `@Inject` constructor for Gradle services
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/commands/ApplicationContextCommandTask.groovy	Make task abstract and add `@Inject` constructor for Gradle services
grails-gradle/plugins/build.gradle	Switch Groovy dependency coordinates to `org.apache.groovy`
grails-gradle/model/src/test/groovy/grails/io/IOUtilsSpec.groovy	Update test expectation for Spock Groovy 4 artifact name
grails-gradle/model/build.gradle	Switch Groovy deps to `org.apache.groovy` coordinates (including tests)
grails-gradle/gradle/wrapper/gradle-wrapper.properties	Update Gradle wrapper to 9.3.1
grails-gradle/common/build.gradle	Switch Groovy deps to `org.apache.groovy` coordinates (including tests)
grails-gradle/bom/build.gradle	Use Gradle-embedded Groovy BOM via `org.apache.groovy:groovy-bom`
grails-forge/test-core/build.gradle	Switch Groovy dependency coordinates to `org.apache.groovy`
grails-forge/grails-forge-web-netty/build.gradle	Remove explicit Shadow plugin; add Micronaut Jackson databind runtime dep
grails-forge/grails-forge-core/src/main/java/org/grails/forge/util/GitHubUtil.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-core/src/main/java/org/grails/forge/feature/build/gradle/templates/gradleWrapperProperties.rocker.raw	Update generated wrapper template to Gradle 9.3.1
grails-forge/grails-forge-core/src/main/java/org/grails/forge/client/github/oauth/AccessToken.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-core/build.gradle	Switch to Micronaut platform BOM; update Groovy coords; add validation/Jackson APIs
grails-forge/grails-forge-cli/build.gradle	Switch to Micronaut platform BOM; update Groovy coords and resolution strategy
grails-forge/grails-forge-api/src/test/groovy/org/grails/forge/api/DiffClient.groovy	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/diff/DiffOperations.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/diff/DiffController.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/zip/ZipCreateOperation.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/zip/ZipCreateController.java	Add `@Validated`; migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/github/GitHubRedirectService.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/github/GitHubCreateService.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/github/GitHubCreateOperation.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/github/GitHubCreateController.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/src/main/java/org/grails/forge/api/create/AbstractCreateController.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-api/build.gradle	Switch to Micronaut platform BOM; add validation processor; jakarta inject; Jackson runtime
grails-forge/grails-forge-analytics-postgres/src/main/java/org/grails/forge/analytics/postgres/Application.java	Migrate validation annotations to `jakarta.validation`
grails-forge/grails-forge-analytics-postgres/src/main/java/org/grails/forge/analytics/postgres/AnalyticsController.java	Migrate transactions to `jakarta.transaction`
grails-forge/grails-forge-analytics-postgres/build.gradle	Remove explicit Shadow plugin; add Micronaut Jackson databind runtime dep
grails-forge/gradle/wrapper/gradle-wrapper.properties	Update Gradle wrapper to 9.3.1
grails-forge/gradle/test-config.gradle	Add Gradle 9 test runtime deps + JVM args for Java 17+
grails-forge/gradle/micronaut-openapi-config.gradle	Replace deprecated `WriteProperties.outputFile` with `destinationFile`
grails-forge/gradle/doc-config.gradle	Switch Groovy documentation deps to `org.apache.groovy`
grails-forge/gradle.properties	Bump Micronaut/Groovy/Spock versions; add Byte Buddy version; update Jakarta inject version
grails-forge/buildSrc/src/main/java/org/grails/forge/rocker/plugin/RockerSourceSetProperty.java	Replace deprecated Gradle configure util; add DSL delegation helpers
grails-forge/buildSrc/src/main/java/org/grails/forge/rocker/plugin/RockerPlugin.java	Replace deprecated convention/DSL object usage with `JavaPluginExtension` + `ExtensionAware`
grails-data-neo4j/docs/build.gradle	Update docs configuration attributes + switch Groovy coords to `org.apache.groovy`
grails-data-mongodb/docs/build.gradle	Update docs configuration attributes for Gradle 9 variant-aware resolution
grails-data-hibernate5/docs/build.gradle	Update docs configuration attributes for Gradle 9 variant-aware resolution
gradle/wrapper/gradle-wrapper.properties	Update root Gradle wrapper to 9.3.1
gradle.properties	Bump `gradleToolingApiVersion` to 9.3.1
dependencies.gradle	Bump gradle-spock BOM version to Groovy 4 compatible variant
build-logic/plugins/src/main/groovy/org/apache/grails/buildsrc/SbomPlugin.groovy	Add license mapping for Coherence BOM 25.03.2
build-logic/gradle/wrapper/gradle-wrapper.properties	Update build-logic Gradle wrapper to 9.3.1
build-logic/docs-core/src/main/groovy/grails/doc/ant/DocPublisherTask.groovy	Add missing AntBuilder import for Groovy/Gradle compatibility
build-logic/docs-core/build.gradle	Switch Groovy coords to `org.apache.groovy` and update Groovy test artifact
.sdkmanrc	Update SDKMAN Gradle version to 9.3.1

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

...ugins/src/main/groovy/org/grails/gradle/plugin/commands/ApplicationContextCommandTask.groovy

grails-forge/gradle/test-config.gradle

Update asciidoctor plugin version for consistency across modules. Note: The StartParameter.isConfigurationCacheRequested deprecation warning remains as it's caused by the grolifant library used by asciidoctor-gradle-plugin. This will be fixed in version 5.0.0 (currently in alpha) which upgrades to Grolifant 5.

jdaugherty · 2026-01-30T15:35:38Z

Have you tested the extractConstraints & bom plugins? It's my understanding that cross project resolution doesn't work in Gradle 9. Have you diffed the versions to see that it's working?

jamesfredley · 2026-01-30T15:37:06Z

I did not touch SBOM in this PR. Grails BOM Dependencies still generates during grails-doc build.

Fix CodeNarc violations by removing unused Gradle API imports that were left over from refactoring.

jamesfredley · 2026-01-30T15:40:10Z

asciidoctor still results in a deprecation warning, which will be resolved in 5 https://github.com/asciidoctor/asciidoctor-gradle-plugin/releases

Add explicit dependency on groovydoc task from dist task to satisfy Gradle 9's stricter validation of implicit task dependencies. The dist task uses outputDir (build/docs) which includes the output from the groovydoc task (build/docs/groovydoc), so an explicit dependency is required.

jamesfredley · 2026-01-30T19:04:49Z

All the BOM and build-logic plugins are working correctly:

✅ grails-bom:extractConstraints - SUCCESS
✅ grails-bom:build - SUCCESS
✅ grails-gradle-bom:build - SUCCESS
✅ build-logic:build - SUCCESS

jdaugherty · 2026-01-30T19:48:50Z

The reports in those other tickets claim that they execute but the wrong datasets are returned with gradle 9. I would suggest diffing the output of those files and clearing any local cache before calling this a victory.

jamesfredley · 2026-01-30T20:38:14Z

grails-bom and /ref/Versions/Grails%20BOM.html have the correct dependencies and versions.

- Update com.gradle.develocity from 4.1.1 to 4.3.2 (latest compatible with Develocity 2025.4.2) - Update com.gradle.common-custom-user-data-gradle-plugin from 2.3 to 2.4.0 - Migrate grails-data-neo4j and grails-data-graphql from deprecated gradle-enterprise plugin to develocity - Add reproducible build configuration to grails-data-neo4j and grails-data-graphql settings - Add comment documenting known Asciidoctor plugin deprecation (StartParameter.isConfigurationCacheRequested)

Fix deprecated Task.project access at execution time (scheduled for removal in Gradle 10) by capturing project properties at configuration time. Changes: - SbomPlugin: Capture projectName, projectPath, and buildDate at configuration time; refactor pickLicense() to accept these values instead of task reference - PublishPlugin: Capture PublishingExtension at configuration time before doLast block - GrailsGradlePlugin: Capture buildDir at configuration time for buildProperties task; capture antBuilder at configuration time for native2ascii task - GrailsProfileGradlePlugin: Replace project.sync in doLast with Sync task type Tested output before/after changes: - cyclonedxBom: Identical (except expected timestamp/UUID differences) - savePublishedArtifacts: Identical - processProfileResources: Identical - buildProperties: Functionally identical (minor formatting: one less blank line) - grails-doc docs: Identical (verified Grails BOM.html)

Replace deprecated leftShift operator (<<) with modern tasks.register and doLast syntax for Gradle 9+ compatibility.

Update gradle-wrapper.jar, gradlew, and gradlew.bat across all locations: - Main project (gradle/) - build-logic/ - grails-gradle/ - grails-forge/ - grails-forge/grails-forge-core/src/main/resources/gradle/ (template) - grails-profiles/base/skeleton/ (template) - grails-profiles/profile/skeleton/ (template) - grails-shell-cli/src/test/resources/gradle-sample/

jamesfredley added 2 commits January 30, 2026 07:45

Copilot AI review requested due to automatic review settings January 30, 2026 15:24

github-project-automation bot added this to Apache Grails Jan 30, 2026

Copilot started reviewing on behalf of jamesfredley January 30, 2026 15:24 View session

Copilot AI reviewed Jan 30, 2026

View reviewed changes

...ugins/src/main/groovy/org/grails/gradle/plugin/commands/ApplicationContextCommandTask.groovy Outdated Show resolved Hide resolved

grails-forge/gradle/test-config.gradle Show resolved Hide resolved

Remove unused imports in ApplicationContextCommandTask

80ee39c

Fix CodeNarc violations by removing unused Gradle API imports that were left over from refactoring.

jamesfredley added 3 commits January 31, 2026 09:42

Merge branch '8.0.x' into upgrade/gradle-9.3.1

e8c9890

jamesfredley force-pushed the upgrade/gradle-9.3.1 branch from 3d4c6ea to 480ad17 Compare January 31, 2026 16:08

jamesfredley added 4 commits January 31, 2026 11:38

Fix deprecated task syntax in gradle-sample test resources

d2ba460

Replace deprecated leftShift operator (<<) with modern tasks.register and doLast syntax for Gradle 9+ compatibility.

Merge branch '8.0.x' into upgrade/gradle-9.3.1

eb659cf

Merge branch '8.0.x' into upgrade/gradle-9.3.1

a52f2df

jamesfredley added the relates-to:v8 Grails 8 label Feb 3, 2026

jamesfredley linked an issue Feb 5, 2026 that may be closed by this pull request

Grails 8.x.x: Gradle 9 support #14738

Open

jamesfredley moved this to In Progress in Apache Grails Feb 5, 2026

jamesfredley added this to the grails:8.0.0-M1 milestone Feb 5, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Upgrade to Gradle 9.3.1 and Micronaut 4 #15365

Upgrade to Gradle 9.3.1 and Micronaut 4 #15365

jamesfredley commented Jan 30, 2026 •

edited

Loading

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Upgrade to Gradle 9.3.1 and Micronaut 4 #15365

Are you sure you want to change the base?

Upgrade to Gradle 9.3.1 and Micronaut 4 #15365

Conversation

jamesfredley commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Gradle 9.3.1 Upgrade

Develocity Plugin Update

Task.project Deprecation Fixes

Micronaut 4 Upgrade (grails-forge)

Test Infrastructure Updates

Testing

Application Testing

Plugin Output Verification

Known Deprecation Warnings

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

jdaugherty commented Jan 30, 2026

Uh oh!

jamesfredley commented Jan 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jamesfredley commented Jan 30, 2026 •

edited

Loading