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 表现得像本地对应的 Javadoc。实现它的设置在哪里？

Answer 1

如下更改 mvn javadoc:javadoc 行对我有用：

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

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

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

Maven Javadoc warnings become errors in GitLab CI

maven-javadoc-plugin

gitlab-ci