在使用maven打包时报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>
三、使用以下命令进行install
mvn clean install -Dmaven.test.skip=true -X -Dmaven.javadoc.skip=true