Right-click a task in Buildship's Gradle Tasks view and choose "Debug Gradle Tasks": the build runs as usual and the debugger is attached to every JVM it forks. Breakpoints work in application code started by JavaExec tasks (run, bootRun, custom server launchers) and in tests.
Features
- "Debug Gradle Tasks" in the context menu of the Gradle Tasks view, for one or more tasks.
- Debug mode for every Buildship "Gradle Task" run configuration, from the Debug toolbar and Debug Configurations.
- Every forked JVM connects to Eclipse on a free port: no Remote Java Application, no Launch Group, no fixed debug port, several JVMs at once (e.g. parallel test workers).
- Hot code replace with the classes Gradle compiles: when you save a Java file, its project is compiled by Gradle and the changed classes are replaced in the running JVM, lambdas included.
- Stopping the "Gradle build" entry in the Debug view stops the build and its JVMs.
- Works with the Gradle configuration cache, which stays reusable from one debug session to the next.
How it works
Eclipse listens for debuggee JVMs, and Buildship runs the build with an init script that starts every task implementing JavaForkOptions with the JDWP agent in client mode, pointing to Eclipse. Your build scripts are not changed.
Requirements: Eclipse 2024-06 or later with Buildship 3.1 or later (included in the Eclipse IDE packages), Java 17 or later, Gradle 5.6 or later for full support.
Open source under the Eclipse Public License 2.0. Feedback and issues are welcome on GitHub.
Categories: Application Development Frameworks, Application Server, IDE, Testing, Tools
Tags: tools, build, debug, gradle, nature_org.eclipse.buildship.core.gradleprojectnature, debugger, spring
Additional Details
Eclipse Versions: 2026-12 (4.42), 2026-09 (4.41), 2026-06 (4.40), 2026-03 (4.39), 2025-12 (4.38), 2025-09 (4.37), 2025-06 (4.36), 2025-03 (4.35), 2024-12 (4.34), 2024-09 (4.33), 2024-06 (4.32)
Platform Support: Windows, Mac, Linux/GTK
Development Status: Production/Stable
Date Created: Thursday, October 8, 2026 - 17:15
License: EPL 2.0
Date Updated: Tuesday, October 20, 2026 - 08:18
Submitted by: Gionata Legrottaglie
Unsuccessful Installs
Unsuccessful Installs in the last 7 Days: 2
| Count | Error Message |
|---|---|
| 2 | Cannot continue the operation. There is another install operation in progress. |

