Java8环境下的Maven javadoc插件的错误排除

今天打包 lightbatis 发布到 Maven 库，出现以下错误：

正在构建所有类的索引...
正在生成/Users/lifei/workspace/lightbatis-master/lightbatis-core/target/apidocs/allclasses-frame.html...
正在生成/Users/lifei/workspace/lightbatis-master/lightbatis-core/target/apidocs/allclasses-noframe.html...
正在生成/Users/lifei/workspace/lightbatis-master/lightbatis-core/target/apidocs/index.html...
正在生成/Users/lifei/workspace/lightbatis-master/lightbatis-core/target/apidocs/overview-summary.html...
正在生成/Users/lifei/workspace/lightbatis-master/lightbatis-core/target/apidocs/help-doc.html...
18 个错误
100 个警告
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  8.792 s
[INFO] Finished at: 2019-12-05T14:24:42+08:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.1.1:jar (attach-javadocs) on project lightbatis-core: MavenReportException: Error while generating Javadoc: 
[ERROR] Exit code: 1 - /Users/lifei/workspace/lightbatis-master/lightbatis-core/src/main/java/titan/lightbatis/mybatis/configuration/LightbatisAutoConfiguration.java:227: 错误: 找不到引用
[ERROR]      * instances of {@link MapperFactoryBean}. If
[ERROR]                            ^
[ERROR] /Users/lifei/workspace/lightbatis-master/lightbatis-core/src/main/java/titan/lightbatis/mybatis/configuration/LightbatisMapperFactoryBean.java:22: 警告: @param 没有说明
[ERROR]      * @param mapperInterface
[ERROR]        ^
[ERROR] /Users/lifei/workspace/lightbatis-master/lightbatis-core/src/main/java/titan/lightbatis/mybatis/provider/impl/BaseMapperProvider.java:38: 警告: @param 没有说明
[ERROR]      * @param ms
[ERROR]        ^
[ERROR] /Users/lifei/workspace/lightbatis-master/lightbatis-core/src/main/java/titan/lightbatis/mybatis/provider/impl/BaseMapperProvider.java:40: 警告: 没有 @return
[ERROR]     public String updateByPrimaryKey(MappedStatement ms) throws IOException {
[ERROR]                   ^
[ERROR] /Users/lifei/workspace/lightbatis-master/lightbatis-core/src/main/java/titan/lightbatis/mybatis/provider/impl/BaseMapperProvider.java:40: 警告: java.io.IOException没有 @throws
[ERROR]     public String updateByPrimaryKey(MappedStatement ms) throws IOException {
[ERROR]                   ^

解决办法：

                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <executions>
                            <execution>
                                <id>attach-javadocs</id>
                                <goals>
                                    <goal>jar</goal>
                                </goals>
                            </execution>
                        </executions>
                        <configuration>
                            <encoding>UTF-8</encoding>
                            <charset>UTF-8</charset>
                            <additionalOptions>
                                <additionalOption>-Xdoclint:none</additionalOption>
                            </additionalOptions>
                        </configuration>
                    </plugin>