El enfoque más fácil para hacer que las cosas funcionen con java 8 y java 7 es usar un perfil en la compilación:

<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>

Esta es la forma más concisa que conozco de ignorar las advertencias de doclint independientemente de la versión de Java utilizada. No hay necesidad de duplicar la configuración del plugin en múltiples perfiles con ligeras modificaciones.

<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>

Probado en oracle/open jdk 6, 7 y 8.

Añada en la sección propiedades globales del archivo pom:

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

La solución común proporcionada aquí en las otras respuestas (agregando esa propiedad en la sección plugins) no funcionó por alguna razón. Solo configurándolo globalmente pude construir el jar de javadoc con éxito.

La solución más corta que funcionará con cualquier versión de Java:

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

Solo agrega eso a tu POM y estarás listo.

Esto es básicamente la respuesta de@ankon más La respuesta de@zapp.

Para los usuarios de maven-javadoc-plugin 3.0.0:

Sustitúyase

<additionalparam>-Xdoclint:none</additionalparam>

Por

<doclint>none</doclint>

Overriding maven-javadoc-plugin configuration only, no soluciona el problema con mvn site (usado por ejemplo durante la etapa de lanzamiento). Esto es lo que tenía que hacer:

<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>

No creo que apagar DocLint sea una buena solución, al menos no a largo plazo. Es bueno que Javadoc se haya vuelto un poco más estricto, por lo que la forma correcta de solucionar el problema de compilación es arreglar el problema subyacente. Sí, en última instancia, tendrá que arreglar esos archivos de código fuente.

Aquí están las cosas a tener en cuenta que anteriormente podría salirse con la suya:

• HTML mal formado (por ejemplo, una etiqueta final faltante, corchetes sin escape, etc.)
• No válido {@link } s. (lo mismo ocurre con etiquetas similares como @see)
• Valores no válidos @author. Esto solía ser aceptado : @author John <[email protected]> pero ya no es así debido a los corchetes no escapados.
• Las tablas HTML en Javadoc ahora requieren un resumen o leyenda. Ver esta pregunta para la explicación.

Simplemente tendrás que arreglar tus archivos de código fuente y seguir compilando tu Javadoc hasta que pueda compilarse sin errores. Engorroso sí, pero personalmente me gusta cuando he traído mis proyectos hasta Nivel DocLint porque significa que puedo estar más seguro de que el Javadoc que produzco es realmente lo que pretendo.

Por supuesto, existe el problema si está generando Javadoc en algún código fuente que no haya producido usted mismo, por ejemplo, porque proviene de algún generador de código, por ejemplo, wsimport. Es extraño que Oracle no preparara sus propias herramientas para el cumplimiento de JDK8 antes de lanzar JDK8. Parece que no se arreglará hasta Java 9. Sólo en este caso particular I sugiera desactivar DocLint como se documenta en otra parte de esta página.

Puede intentar establecer la propiedad failOnError (consulte la documentación del complemento ) a 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>

Como puede ver en los documentos, el valor predeterminado es true.

Dado que depende de la versión de su JRE que se utiliza para ejecutar el comando maven, probablemente no desee desactivar DocLint por defecto en su pom.xml

Por lo tanto, desde la línea de comandos se puede utilizar el interruptor -Dadditionalparam=-Xdoclint:none.

Ejemplo: mvn clean install -Dadditionalparam=-Xdoclint:none

El nombre de la propiedad de configuración se ha cambiado en la última versión de maven-javadoc-plugin que es 3.0.0.

Por lo tanto el no funcionará. Así que tenemos que modificarlo como se muestra a continuación.

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

A partir de maven-javadoc-plugin 3.0.0 deberías haber estado usando additionalJOption para establecer una opción Javadoc adicional, por lo que si deseas que Javadoc deshabilite doclint, deberías agregar la siguiente propiedad.

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

También debe mencionar la versión de maven-javadoc-plugin como 3.0.0 o superior.

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

No estoy seguro de si esto va a ayudar, pero incluso me enfrenté al mismo problema muy recientemente con oozie-4.2.0 versión. Después de leer las respuestas anteriores, acabo de agregar la opción maven a través de la línea de comandos y funcionó para mí. Por lo tanto, sólo compartir aquí.

Estoy usando java 1.8.0_77, no he probado con java 1.7

Bin/mkdistro.sh -DskipTests - Dmaven.javadoc.opts=' - Xdoclint: - html'

Añadido a continuación

JAVA_TOOL_OPTIONS= - DadditionalJOption= - Xdoclint: none

En Jenkins job configuración > Entorno de compilación > Inyectar variables de entorno al proceso de compilación > Contenido de propiedades

Resuelto mi problema de la construcción de código a través de Jenkins Maven: -)

Así que, ahórrate algunas horas que no hice y prueba esto si parece que no funciona:

 <additionalJOption>-Xdoclint:none</additionalJOption>

La etiqueta se cambia para las versiones más recientes.

Me gustaría añadir algo de información sobre otras respuestas

En mi caso

- Xdoclint: none

No funcionó.

Comencemos con eso, en mi proyecto, realmente no necesitaba javadoc en absoluto. Solo algunos plugins necesarios tenían una dependencia de tiempo de construcción en él.

Entonces, la forma más sencilla de resolver mi problema fue:

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

Llego un poco tarde a la fiesta, pero también me vi obligado a buscar una solución alternativa, terminé aquí y luego la encontré.

Esto es lo que funciona para mí: -

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

Y luego inicie su compilación Maven, cualquier compilación de distribución de Linux, etc. Lo bueno de esto es que no requiere la modificación de archivos Maven config - no pude hacerlo ya que mi objetivo era reconstruir un montón de paquetes rpm Centos, así que tuve que ir muy profundo.

Para ignorar las etiquetas faltantes @param y @return, basta con desactivar missing doclint group . De esta manera, el javadoc todavía se revisará para problemas de nivel superior y sintaxis:

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

Tenga en cuenta que esto es para plugin versión 3.0 o más reciente.