私はMavenを使用しているので、不完全なJavadocタグ（たとえば、欠落しているパラメーター）があるローカルリポジトリプロジェクトにビルドしてインストールすることができました。

ただし、Java 8（1.8.0-ea-b90）に移行したので、Mavenはドキュメントタグの欠落に厳格であり、Javadocがないプロジェクトをビルドまたはインストールしようとすると、Javadocの問題に関連する多くのJavadocエラーが表示されます「完璧」。ローカルリポジトリにコンパイルしてインストールしようとしているプロジェクトの一部は、私が制御できないサードパーティのプロジェクトです。したがって、これらのすべてのプロジェクトですべてのJavadocを修正するという回避策は、私のシナリオでは実行可能ではないようです。

これはmvn clean package install、プロジェクトで実行したときに表示される出力の一部です。

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.026s
[INFO] Finished at: Mon Apr 08 21:06:17 CEST 2013
[INFO] Final Memory: 27M/437M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (attach-javadocs) on project jpc: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:10: error: @param name not found
[ERROR] * @param terms the terms to assert
[ERROR] ^
[ERROR] /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:11: warning: no description for @return
[ERROR] * @return
[ERROR] ^

Javadoc Mavenプラグインは、私のPOMで次のように構成されています。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

前に言ったように、Java 7に戻ると、すべてが正常に機能しています。これは、Java 8で実行されているMavenに関連するバグですか？Java 8で動作させるにはどうすればよいですか（つまり、プロジェクトのJavadocをビルドして、そのコードをローカルリポジトリにインストールできますか）。OSXでMaven 3.0.3と3.0.5の両方でテストしました。

更新：

<failOnError>false</failOnError>（Martinに感謝）でJavadocプラグイン構成を変更した場合：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

次に、プロジェクトがローカルリポジトリにインストールされます。ただし、Javadoc JARはまだ生成されていません。

この新しい構成でコンソールに表示される出力の一部は次のとおりです。

[エラー] MavenReportException：アーカイブの作成中にエラーが発生しました：終了コード：1-/Users/....java:18：警告：no @param ...コマンドライン：/ Library / Java / Home / bin / javadoc @options @パッケージ

'/ Users / sergioc / Documents / workspaces / heal / minitoolbox / target / apidocs'ディレクトリにある生成されたJavadocファイルを参照してください。

org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeJavadocCommandLine（AbstractJavadocMojo.java:5043）at org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeReport（AbstractJavadocMojo.java:1990）at org.apache.maven.plugin .javadoc.JavadocJar.execute（JavadocJar.java:181）at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo（DefaultBuildPluginManager.java:101）at org.apache.maven.lifecycle.internal.MojoExecutor.execute（MojoExecutor.java ：209）org.apache.maache.lifecycle.internal.MojoExecutor.execute（MojoExecutor.java:153）at org.apache.maven.lifecycle.internal.MojoExecutor.execute（MojoExecutor.java:145）at org.apache。 org.apache.maven.lifecycle.internal.LifecycleModuleBuilderのmaven.lifecycle.internal.LifecycleModuleBuilder.buildProject（LifecycleModuleBuilder.java:84）。buildProject（LifecycleModuleBuilder.java:59）at org.apache.maven.lifecycle.internal.LifecycleStarter.singleThreadedBuild（LifecycleStarter.java:183）at org.apache.maven.lifecycle.internal.LifecycleStarter.execute（LifecycleStarter.java:161） org.apache.maven.DefaultMaven.execute（DefaultMaven.java:156）at org.apache.maven.cli.MavenCli.execute（MavenCli.java）にあるorg.apache.maven.DefaultMaven.doExecute（DefaultMaven.java:320）に：537）org.apache.maven.cli.MavenCli.doMain（MavenCli.java:196）at org.apache.maven.cli.MavenCli.main（MavenCli.java:141）at sun.reflect.NativeMethodAccessorImpl.invoke0（ネイティブメソッド）at sun.reflect.NativeMethodAccessorImpl.invoke（NativeMethodAccessorImpl.java:57）at sun.reflect.DelegatingMethodAccessorImpl.invoke（DelegatingMethodAccessorImpl.java:43）at java.lang.reflect.Method。org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced（Launcher.java:290）at org.codehaus.plexus.classworlds.launcher.Launcher.launch（Launcher.java:230）のinvoke（Method.java:491） org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode（Launcher.java:409）org.codehaus.plexus.classworlds.launcher.Launcher.main（Launcher.java:352）で

ソースのビルド、プロジェクトのインストール、およびJavadoc JARの生成方法について、Java 7で動作していたのと同じように、1つのステップで回避策はありますか？

最善の解決策は、javadocエラーを修正することです。何らかの理由で不可能である場合（つまり、自動生成されたソースコード）、このチェックを無効にすることができます。

DocLintはJava 8の新機能で、次のように要約されています。

開発サイクルの初期にJavadocコメントのエラーを検出する手段を提供し、ソースコードに簡単にリンクできるようにします。

これはデフォルトで有効になっており、Javadocsを生成する前に多くのチェックを実行します。このスレッドで指定されているように、Java 8ではこれをオフにする必要があります。これをMaven構成に追加する必要があります。

<profiles>
  <profile>
    <id>java8-doclint-disabled</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>
<build>
  <plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
                <configuration>
                    <additionalparam>${javadoc.opts}</additionalparam>
                </configuration>
            </execution>
        </executions>
    </plugin>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>${javadoc.opts}</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
   </plugins>
</build>

maven-javadoc-plugin 3.0.0+の場合： 置き換え

<additionalparam>-Xdoclint:none</additionalparam>

と

<doclint>none</doclint>

Java 8とJava 7の両方で機能する最も簡単な方法は、ビルドでプロファイルを使用することです。

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <additionalparam>-Xdoclint:none</additionalparam>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

使用しているJavaのバージョンに関係なく、doclintの警告を無視することを知っている最も簡潔な方法は次のとおりです。わずかな変更を加えて、複数のプロファイルでプラグイン構成を複製する必要はありません。

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>2.9.1</version>
      <executions>
        <execution>
          <id>attach-javadocs</id> <!-- The actual id should be apparent from maven output -->
          <configuration>
            <additionalparam>${javadoc.opts}</additionalparam>
          </configuration>
        </execution>
      </executions>
    </plugin>
    ...
  </plugins>
</build>

oracle / open jdk 6、7、8、11でテスト済み。

pomファイルのグローバルプロパティセクションに追加します。

<project>
    ...
    <properties>
        <additionalparam>-Xdoclint:none</additionalparam>
    </properties>

他の回答でここに提供されている一般的な解決策（プラグインセクションにそのプロパティを追加）は、何らかの理由で機能しませんでした。グローバルに設定することによってのみ、javadoc jarを正常に構築できました。

任意のJavaバージョンで機能する最も短いソリューション：

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

それをPOMに追加するだけでよいのです。

これは基本的に@ankonの回答と@zappの回答です。

maven-javadoc-plugin 3.0.0ユーザーの場合：

交換する

<additionalparam>-Xdoclint:none</additionalparam>

沿って

<doclint>none</doclint>

少なくとも長期的には、DocLintをオフにするだけで良い解決策になるとは思いません。Javadocがもう少し厳しくなっているのは良いことなので、ビルドの問題を修正する正しい方法は、根本的な問題を修正することです。はい、最終的にそれらのソースコードファイルを修正する必要があります。

以下は、以前に回避できる可能性のある注意事項です。

• 不正なHTML（たとえば、終了タグの欠落、エスケープされていないブラケットなど）
• 無効{@link }です。（のような同様のタグについても同様です@see）
• 無効な@author値。これは以前は受け入れられて@author John <john.doe@mine.com>いましたが、ブラケットがエスケープされていないため、現在は受け入れられていません。
• JavadocのHTMLテーブルには、要約またはキャプションが必要になりました。説明については、この質問を参照してください。

ソースコードファイルを修正し、Javadocが失敗せずにビルドできるようになるまで、Javadocをビルドし続ける必要があります。面倒です。ただし、プロジェクトをDocLintレベルに上げたときは個人的に気に入っています。これは、作成するJavadocが実際に意図したとおりであることを確信できるためです。

もちろん、たとえばwsimportなどのコードジェネレーターからのものなど、自分で作成していないソースコードでJavadocを生成する場合には問題があります。オラクルが実際にJDK8をリリースする前にJDK8準拠のための独自のツールを準備しなかったのは奇妙です。そうです、それは、Java 9までは固定されません。この特定の場合にのみ、このページの他の箇所で説明されているように、DocLintをオフにすることをお勧めします。

maven-javadoc-plugin構成のみをオーバーライドしても、mvn site（リリース段階などで）使用される問題は修正されません。これが私がしなければならなかったことです：

<profile>
  <id>doclint-java8-disable</id>
  <activation>
    <jdk>[1.8,)</jdk>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

failOnErrorプロパティ（プラグインのドキュメントを参照）をfalse次のように設定してみてください。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
              <failOnError>false</failOnError>
            </configuration>
        </execution>
    </executions>
</plugin>

ドキュメントからわかるように、デフォルト値はtrueです。

mavenコマンドを実行するために使用されるJREのバージョンに依存するためDocLint、pom.xmlでデフォルトで無効にしたくないと思うでしょう。

したがって、コマンドラインからスイッチを使用できます-Dadditionalparam=-Xdoclint:none。

例： mvn clean install -Dadditionalparam=-Xdoclint:none

maven-javadoc-pluginの最新バージョン3.0.0で構成プロパティ名が変更されました。

したがって、<additionalparam>は機能しません。したがって、以下のように変更する必要があります。

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>3.0.0</version>
      <configuration>
         <doclint>none</doclint>
      </configuration>
  </plugin>

他の答えに洞察を加えたい

私の場合

-Xdoclint：none

うまくいきませんでした。

まず、私のプロジェクトでは、javadocはまったく必要ありませんでした。一部の必要なプラグインのみがビルド時に依存していました。

だから、私の問題を解決する最も簡単な方法は：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

Mavenの-javadocによってプラグイン3.0.0のとおり、あなたは使用されている必要がありますadditionalJOptionを追加のJavadocオプションを設定するには、あなたが無効にdoclintへのJavadocをご希望の場合は、次のプロパティを追加する必要があります。

<properties>
    ...
    <additionalJOption>-Xdoclint:none</additionalJOption>
    ...
<properties>

また、maven-javadoc-pluginのバージョンを3.0.0以降と記載する必要があります。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.0</version>    
</plugin>

だから、私がしなかった数時間を節約し、うまくいかないようであればこれを試してください：

 <additionalJOption>-Xdoclint:none</additionalJOption>

新しいバージョンではタグが変更されています。

以下に追加

JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

ジェンキンスの仕事に：

構成>ビルド環境>ビルドプロセスに環境変数を挿入>プロパティコンテンツ

Jenkins Mavenによるコード構築の問題を解決しました:-)

これが役立つかどうかはわかりませんが、oozie-4.2.0バージョンでまったく同じ問題に最近直面しました。上記の回答を読んだ後、コマンドラインからmavenオプションを追加したところ、うまくいきました。ここで共有するだけです。

私はJava 1.8.0_77を使用していますが、Java 1.7では試していません

bin / mkdistro.sh -DskipTests -Dmaven.javadoc.opts = '-Xdoclint：-html'

不足@paramしている@returnタグやタグを無視するには、missing doclintグループを無効にするだけで十分です。このようにして、Javadocはより高いレベルと構文の問題がないかチェックされます。

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <doclint>all,-missing</doclint>
        </configuration>
    </plugin>

これはプラグインバージョン3.0以降用であることに注意してください。

パーティーには少し遅れましたが、回避策も検索せざるを得ず、ここまでたどり着きました。

これは私のために働くものです：-

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

そして、それはMavenの必要がないこと、それについてなどニースの事あなたのMavenのビルド、どのLinuxディストリビューションのビルドを開始する設定ファイルの変更を-私は私の目的はの束再構築するためにあったようにそれを行うことができなかったのCentOS rpmパッケージを、そうしなければなりませんでした本当に深く行きます。