在使用release插件打包时报MavenReportException: Error while generating Javadoc错误,这个是由于jdk8之后javadoc工具默认是开启doclint来检查注释格式的,一般我们写注释都不是完全遵循该规范,所以需要在maven中关闭该检查。

添加-Xdoclint:none便可关闭检查。“-Xdoclint:none”只是JDK 8中有的,如果使用的是JDK 8之前的版本,一定不能有这个,否则maven跑不过。 所以我们可以借助profile激活条件来限制区分。

一、maven-javadoc-plugin小于3.0.0

<!-- profiles 中添加激活条件 -->
<profile>
	<id>java8-doclint-disabled</id>
	<activation>
		<jdk>[1.8,)</jdk>
	</activation>
	<properties>
		<additionalparam>-Xdoclint:none</additionalparam>
	</properties>
</profile>
<!-- plugins 中配置maven-javadoc-plugin的additionalparam参数 -->
<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-javadoc-plugin</artifactId>
	<version>2.10.4</version>
	<configuration>
		<additionalparam>${additionalparam}</additionalparam>
	</configuration>
</plugin>

二、maven-javadoc-plugin大于3.0.0

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-javadoc-plugin</artifactId>
	<configuration>
		<doclint>none</doclint>
	</configuration>
</plugin>