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

【问题标题】：Maven Javadoc warnings become errors in GitLab CIMaven Javadoc 警告成为 GitLab CI 中的错误
【发布时间】：2020-12-09 01:30:58
【问题描述】：

当我在本地运行 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 能够像其本地对应物一样运行。实现这一目标的设置在哪里？

【问题讨论】：

@DV82XL 除了在每行的开头添加额外的 4 个空格之外，您的编辑建议还有什么意义？ variables 和 deploy 是我的 .yml 中的顶级元素，没有缩进。查看差异，每行至少有 4 个空格缩进（将.yml 标记为代码）已经存在......

标签： gitlab-ci maven-javadoc-plugin

【解决方案1】：

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

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

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

【讨论】：