JDK8 - файл класса ошибок для javax.interceptor.InterceptorBinding не найден при попытке сгенерировать javadoc с использованием плагина Maven javadoc

Похоже, это связано с тем, что javax.transaction.Transactional (или любой другой класс в вашем пути к классам, если на то пошло) сам аннотирован javax.interceptor.InterceptorBinding, который отсутствует в пути к классам, если явно не объявлен в зависимостях:

@Inherited
@InterceptorBinding // <-- this ONE is causing troubles
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Transactional {

Сказал, что:

• javax.transaction.Transactional - поставляется с javax.transaction: javax.transaction-api: 1. + (или org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec:1.0.0.Final) и обычно используется в приложениях JPA / ORM / JMS для аннотирования методов транзакций.
• javax.interceptor.InterceptorBinding - должен идти с javax.interceptor: javax.interceptor-api: 1. +. Но, хотя он объявлен поверх Transactional, он не требуется для нормальной работы и (похоже, из-за этого) не извлекается как транзитивная зависимость вашего фреймворка JPA.

В результате инструмент javadoc JDK8 не может обработать источники (если какие-либо из них помечены знаком @Transactional).

Хотя можно было бы более конкретно о том, где была обнаружена эта «ошибка».

Исправление проблемы: добавление javax.interceptor:javax.interceptor-api:1.+ зависимости устраняет проблему.

<dependency>
    <groupId>javax.interceptor</groupId>
    <artifactId>javax.interceptor-api</artifactId>
    <version>1.2.2</version>
</dependency>

Примечание (январь 2020 г.): последней (вероятной) версией в настоящее время является 1.2.2 (см. https://mvnrepository.com/artifact/javax.interceptor/javax.interceptor-api

Как уже упоминает @kozlovda, проблема связана с аннотацией @Transactional (javax.transaction.Transactional).

Если у вас есть описанная ошибка при запуске Maven для приложения Spring, есть также другой способ решить проблему: убедитесь, что не используете аннотацию из javax.transaction, вместо этого используйте org.springframework.transaction.annotation.Transactional.

Замена импорта устранила проблему для меня.

@lpratlong говорит в ответе, предоставленном в комментарии, «добавьте его в качестве дополнительных зависимостей maven-javadoc-plugin». Это сработало для меня, вот полная запись плагина Maven для нетерпеливых людей, таких как я, для копирования и вставки:

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <!-- <version>3.0.0</version> -->
            <configuration>
                <!-- Silence error javax.interceptor.InterceptorBinding not found -->
                <additionalDependencies>
                    <additionalDependency>
                        <groupId>javax.interceptor</groupId>
                        <artifactId>javax.interceptor-api</artifactId>
                        <version>1.2</version>
                    </additionalDependency>
                </additionalDependencies>
            </configuration>
        </plugin>

Версия закомментирована, потому что в моем случае Spring-boot управляет версией, просто восстанавливайте по мере необходимости.

Вы также можете добавить следующую строку в конфигурацию javadoc maven: <failOnError>false</failOnError>. Это укажет выполнению javadoc игнорировать все ошибки и не допустить сбоя сборки.

Таким образом, ваша полная конфигурация плагина javadoc будет выглядеть так:

<build>
   <plugins>
       <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-compiler-plugin</artifactId>
           <configuration>
               <source>1.8</source>
               <target>1.8</target>
           </configuration>
       </plugin>
       <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
           <configuration>
               <additionalparam>-Xdoclint:none</additionalparam>
               <failOnError>false</failOnError>
           </configuration>
       </plugin>
    </plugins>
</build>

Использовать

import org.springframework.transaction.annotation.Transactional;

вместо

import javax.transaction.Transactional;

когда вы используете @Transactional с Spring

InterceptorBinding доступен при следующей зависимости maven:

<dependency>
    <groupId>javax.interceptor</groupId>
    <artifactId>javax.interceptor-api</artifactId>
    <version>1.2</version>
</dependency>

У меня была такая же проблема с Spring-Boot 2 Kotlin и gradle. Как предположил @kozlovda:

dependencies {
  compileOnly 'javax.interceptor:javax.interceptor-api:1.+'
  ...

исправил проблему

Заменить, как показано ниже

import org.springframework.transaction.annotation.Transactional;

@Service
@Transactional
public class WorkingService

Вы также можете добавить зависимость Maven в свой файл POM. Это решило эту проблему для меня

    <dependency>
        <groupId>net.sourceforge.cobertura</groupId>
        <artifactId>cobertura</artifactId>
        <version>2.1.1</version>
        <scope>compile</scope>
    </dependency>