OSGI版本注释的怪异Javadoc错误（带有JDK12）

Question

随着从 Java 11 到 Java 12 的更改，我们现在在包含 OSGi 版本注释的包信息文件上生成 Javadoc 时看到一个奇怪的错误。

源代码是：

@Version("1.3.0")
package org.apache.jackrabbit.oak.commons;

import org.osgi.annotation.versioning.Version;

错误是：

[ERROR] C:\projects\apache\oak\trunk\oak-commons\src\main\java\org\apache\jackrabbit\oak\commons\package-info.java:17: error: unknown tag: Version
[ERROR] @Version("1.3.0")
[ERROR] ^

(查看详细信息和上下文)

是这是 Java 12 中的回归，还是注释的使用方式有问题，或者 Javadoc 的调用方式（通过 maven）是否有问题？

Answer 1

可能是 Javadoc 错误，因为 Javadoc 将 Java 注释视为 Javadoc 标签。

解决方法 1：
禁用此 Javadoc 标记

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.1.0</version>
                <configuration>                        
                    <tags>
                        <tag>
                            <name>Version</name>                            
                            <placement>X</placement>                            
                        </tag>
                    </tags>
                </configuration>
            </plugin>

解决方法 2：
在每个注释前面添加一个空的 Javadoc 块

/** */@Version("1.3.0")
package org.apache.jackrabbit.oak.commons;

Answer 2

修复程序是升级到更新的JDK版本。

该问题影响了JDK 12，并将其固定在JDK 13中，。

同样的问题也影响了OpenJDK 11.0.17，因为引入Javadoc回归的更改已退回。它固定在JDK 11.0.18中。 （请参阅）

简化的repro：

package p;

import static java.lang.annotation.ElementType.PACKAGE;

import java.lang.annotation.Target;

@Target(PACKAGE)
public @interface A {}

@A
package p;

$ javadoc package-info.java A.java
...
package-info.java:1: error: unknown tag: A
@A
^