最好的解决方案是修复javadoc错误。如果由于某种原因(例如:自动生成的源代码)无法执行,则可以禁用此检查。
DocLint是Java 8中的一项新功能,总结为:
提供一种在开发周期的早期检测Javadoc注释中的错误的方法,并且可以轻松地将其链接回源代码。
默认情况下启用此功能,并且在生成Javadocs之前将运行大量检查。你需要为此线程中指定的Java 8关闭此功能。你必须将其添加到你的Maven配置中:
<profiles> <profile> <id>java8-doclint-disabled</id> <activation> <jdk>[1.8,)</jdk> </activation> <properties> <javadoc.opts>-Xdoclint:none</javadoc.opts> </properties> </profile></profiles><build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.9</version> <executions> <execution> <id>attach-javadocs</id> <goals> <goal>jar</goal> </goals> <configuration> <additionalparam>${javadoc.opts}</additionalparam> </configuration> </execution> </executions> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <version>3.3</version> <configuration> <reportPlugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <additionalparam>${javadoc.opts}</additionalparam> </configuration> </plugin> </reportPlugins> </configuration> </plugin> </plugins></build>对于
maven-javadoc-plugin 3.0.0+: 替换
<additionalparam>-Xdoclint:none</additionalparam>
与
<doclint>none</doclint>



