Maven javadoc插件问题:比较方法违反其常规约定

Question

在部署工件时，我从Maven javadoc插件中得到这个奇怪的错误

C:\Users\oomsa\dev\eclipse\chemspot\src\main\java\org\u_compare\shared\label\penn\function\text\TTL_Type.java:60: warning - @generated is an unknown tag.
C:\Users\oomsa\dev\eclipse\chemspot\src\main\java\org\u_compare\shared\label\penn\function\text\TTL_Type.java:24: warning - @generated is an unknown tag.
javadoc: error - Exception processing overview.
javadoc: error - java.lang.IllegalArgumentException: Comparison method violates its general contract!

Command line was: "C:\Program Files\Java\jdk1.7.0_65\jre\..\bin\javadoc.exe" @options @argfile

Refer to the generated Javadoc files in 'C:\Users\oomsa\dev\eclipse\chemspot\target\apidocs' dir.

        at 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)
        ... 21 more
[ERROR]
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException

它只对一个特定的项目做到这一点，而不是对其他项目。会出什么问题呢？

Answer 1

看起来您是在从基础源代码生成javadoc，而不是那些包含某种类型的生成代码存根的源代码。

就在出现故障之前，您会看到@generated标记未知的错误。我敢打赌，您会缺少编译javadoc所需的一些关键信息(比如一些信息，如果不是全部源代码的话)，因为缺少源代码。

您是否打开并查看了有问题的文件？这是一个很好的起点。