Apache Maven – Skipping unit test using surefire plugin

In this article, we will learn and understand how to skip unit test while building maven based project using surefire plugin

One of the maven’s features is to run unit test automatically and if some of the test cases fail, then maven build fails

Irrespective of the unit test failure, we still need to move on to build the project successfully. In these circumstances, we have to suppress maven from running unit test for us which results in “BUILD FAILURE”

 

1. Skip unit test using surefire plugin

  • If we need to suppress/disable running unit test for a particular project, configure “skipTests” tag to true of surefire plugin in pom.xml

pom.xml

<project>
	[...]
	<properties>
		<skipTests>true</skipTests>
	</properties>
	[...]
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-surefire-plugin</artifactId>
				<version>2.18</version>
				<configuration>
					<skipTests>${skipTests}</skipTests>
				</configuration>
			</plugin>
		</plugins>
	</build>
	[...]
</project>

2. Skipping unit test from command line:

  • You can skip unit test running below maven command
mvn install -DskipTests

Or

mvn install -Dmaven.test.skip=true

2.1 To be noted

  • With above pom.xml configuration, by-default maven suppresses or disable running unit test
  • But to re-enable them, use below maven command from CLI
mvn install -DskipTests=false

Useful Eclipse IDE shortcuts :

Related Articles:

References:

Happy Coding !!
Happy Learning !!

Apache Maven - Exclusions and Inclusions of unit test
Apache Maven - Plugins explanation