Maven Javadoc警告在GitLab CI中变为错误

Question

当我在本地运行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表现得像它的本地同行。实现这一目标的背景在哪里？

Answer 1

按如下方式更改mvn javadoc:javadoc行对我来说很有用：

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

仍然不确定为什么这似乎是我本地Maven安装的默认行为，而不是GitLab，但至少这暂时解决了我的问题。