maven 打包发布javadoc和javasource设置忽略报错

最新推荐文章于 2025-06-26 21:34:21 发布

原创最新推荐文章于 2025-06-26 21:34:21 发布 · 3.7k 阅读

2 ·

CC 4.0 BY-SA版权

maven 同时被 2 个专栏收录

1 篇文章

订阅专栏

javadoc

1 篇文章

订阅专栏

本文介绍了在maven打包发布时，如何处理因缺少javadoc注释导致的部署失败问题。通过在pom.xml中添加maven-javadoc-plugin插件，并配置nonelint选项来忽略注释检查，此方法适用于应急情况，正常情况下建议提供完整的javadoc。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

maven 打包发布javadoc和javasource

项目deploy到中心仓库，会要求检查javadoc和javasource文件的完整性，而这时候代码上如果少了javadoc的注释，在stage close的时候就会失败，因此我们需要在pom文件中添加相关插件，并设置不检查注释，当然如果真的要开源还是不建议这么做，毕竟如果有人要看你的javadoc，而doc内容缺失也是不好的，以下配置仅用于应急，请关注maven-javadoc-plugin的configuration部分

特殊说明：这个插件好像在3.0.0之后才有nonelint这个节点，之前的版本是没有这个的，所以请把插件的版本也做相应升级。

<build>
        <plugins>
          <plugin>
              <groupId>org.sonatype.plugins</groupId>
              <artifactId>nexus-staging-maven-plugin</artifactId>
              <version>1.6.7</version>
              <extensions>true</extensions>
              <configuration>
                <serverId>sonatype-nexus-staging</serverId>
                <nexusUrl>https://oss.sonatype.org/</nexusUrl>
                <autoReleaseAfterClose>true</autoReleaseAfterClose>
              </configuration>
            </plugin>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-source-plugin</artifactId>
              <version>3.0.1</version>
              <executions>
                <execution>
                  <id>attach-sources</id>
                  <goals>
                    <goal>jar-no-fork</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <version>3.0.0</version>
                <configuration>
                    <failOnError>false</failOnError>
                    <doclint>none</doclint>
                </configuration>
              <executions>
                <execution>
                  <id>attach-javadocs</id>
                  <goals>
                    <goal>jar</goal>
                  </goals>
                <phase>package</phase>
                </execution>
              </executions>
            </plugin>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-gpg-plugin</artifactId>
              <version>1.5</version>
              <executions>
                <execution>
                  <id>sign-artifacts</id>
                  <phase>verify</phase>
                  <goals>
                    <goal>sign</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
        </plugins>
        </build>