Maven Javadoc警告成为GitLab CI中的错误

问题描述

当我在本地运行mvn javadoc:javadoc时，它会向我发出一堆警告-空@return标签，未知标签等-但最终会构建Javadoc树。

在GitLab CI上，我在.gitlab-ci-yml中具有以下内容：

    variables:
      MAVEN_OPTS: "-Dhttps.protocols=TLSv1.2 -Dmaven.repo.local=$CI_PROJECT_DIR/.m2/repository -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=WARN -Dorg.slf4j.simpleLogger.showDateTime=true -Djava.awt.headless=true"
    
    # [...]
    
    deploy:jdk8:
      stage: deploy
      script:
        - if [ ! -f ci_settings.xml ];
            then echo "CI settings missing\! If deploying to GitLab Maven Repository,please see https://docs.gitlab.com/ee/user/project/packages/maven_repository.html#creating-maven-packages-with-gitlab-cicd for instructions.";
          fi
        - 'mvn $MAVEN_CLI_OPTS deploy -s ci_settings.xml'
        - 'mvn javadoc:javadoc'
        - 'cp -r target/site/apidocs public/javadoc/dev'
      artifacts:
        paths:
        - public
      only:
        - master
        - dev

在这里，Javadoc生成失败，前面提到的警告被报告为错误。

我最终将修复这些问题，但与此同时，我希望CI上的Javadoc表现得像其本地副本一样。设置在哪里实现？

解决方法

按如下所示更改mvn javadoc:javadoc行对我来说是窍门：

    - 'mvn javadoc:javadoc -DadditionalJOption=-Xdoclint:none'

仍然不确定为什么此错误是我本地Maven安装上的默认行为，而不是GitLab上的默认行为，但这至少现在可以解决我的问题。

gitlab-ci maven-javadoc-plugin