Icon Toiletpaper 122

Remote Debugging of Maven (Surefire) Tests


There is this phenomenon – all unit tests in IntelliJ's IDEA are positive, but Maven disagrees and displays failed tests in your build pipeline by saying "BUILD FAILURE, have fun searching". But how do you actually get the code debugged during build time? Simply setting a breakpoint and running the test again in IntelliJ's debug mode won't work. We need to run the test under the same conditions as Maven does.


We can use the Maven Surefire plugin, which Maven uses during the test phase of the build lifecycle. With the plugin, it is possible to have Maven connecting a port with your IDE. But the remote debugger is not limited to local Maven projects. You can also debug Gradle projects, JARs, applications on other servers, and even Docker containers.


First, we need to create a remote run configuration in IntelliJ IDEA (works similarly in other IDEs like Eclipse, ...), set the port (Maven uses port 5005 by default), and set a few more command line parameters, as displayed in an exemplary configuration:

Screenshot des Maven Debuggers

Then breakpoints can be set and the build process can be started again with the command line parameter -Dmaven.surefire.debug.

For a single test the command could look like this: mvn package -Dtest=TestClass.java#testMethod -Dmaven.surefire.debug

For all tests: mvn package -Dmaven.surefire.debug

Maven reports as soon as it arrives at the tests:

 T E S T S
Listening for transport dt_socket at address: 5005

Now it's time to start the previously created run configuration in IntelliJ IDEA and hope that the breakpoints are set correctly ;). From this point on, we can step through the code as usual and find the cause of our error. In that sense, happy debugging!


Cookie Settings

This website uses cookies to personalize content and ads, provide social media features, and analyze website traffic. In addition, information about your use of the website is shared with social media, advertising, and analytics partners. These partners may merge the information with other data that you have provided to them or that they have collected from you using the services.

For more information, please refer to our privacy policy. There you can also change your cookie settings later on.

contact icon

Contact us now