如何解决“javadoc：警告 - 为包 a.b.c 找到多个包注释来源”？答案

【问题标题】：How to resolve "javadoc: warning - Multiple sources of package comments found for package a.b.c"?如何解决“javadoc：警告 - 为包 a.b.c 找到多个包注释来源”？
【发布时间】：2021-05-29 00:32:27
【问题描述】：

我已经非常过时了，但是我刚刚将我的项目从 JDK 1.4 升级为使用 JDK 1.5，现在在运行 mvn javadoc:javadoc 时，遇到以下 javadoc 警告：

[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.a"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.b"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.c"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.a"

我需要做什么来修复它们？从 JDK 1.4 到 1.5 有什么变化吗？

谢谢！

【问题讨论】：

标签： java maven warnings packages javadoc

【解决方案1】：

（在原始答案后 10 年更新。）

一位老 thread in the Oracle forums 讨论过这个问题。 （很遗憾现在链接失效了，我在新的 Oracle Developer 社区中找不到相同的帖子，也找不到in the Wayback machine）。

据我记得（并且可以从一些 google-ing 中收集到），javadoc 的行为在 JDK 1.4 和 1.5 之间发生了变化，因此多次遇到的包文档会产生此警告。这似乎特别发生在旧版本的 Maven 中——更新到新版本的 Maven（或 maven-javadoc-plugin）似乎有所帮助。

（当然，这意味着 2011 年的 Maven 版本，所以你现在可能拥有的任何版本都应该没问题。）

【讨论】：

不幸的是，该链接不再有效。如果您能更新答案，将会很有帮助。
@Janothan 我找不到相同内容的更新链接（这是 10 年前的），但我添加了一些我发现的细节。