Eclipse中Checkstyle提示Javadoc标签需前置空行但实际已存在空行的原因

• 换行符格式不统一：如果项目文件混用了Windows的CRLF和Unix的LF换行符，旧版本Checkstyle的空行检测逻辑会识别异常，把实际存在的空行判定为非空行触发警告。
• 空行存在不可见字符：你误以为的空行里可能包含多余空格、制表符等不可见内容，Checkstyle会判定该行非空，不符合“空行分隔”的要求。
• Checkstyle插件版本不一致：你本地安装的Eclipse Checkstyle插件版本和老师同学的版本不同，低版本的RequireEmptyLineBeforeBlockTagGroupCheck检查存在已知的空行判定bug，会出现误报，不需要加HTML换行标签来绕过，属于规则本身的问题。
• Javadoc缩进不匹配：如果空行所在行的*符号和上下行Javadoc的*没有对齐，或者缩进格式不满足Google规则集的缩进要求，也会触发误判。比如你给出的示例代码中，Javadoc各行缩进就存在不一致的问题：

/**
   * shows drinks units in fridge.
   * 
   * @return amount of drinks in fridge.
   */

首行/**前的空格数远多于下行*前的空格数，这类缩进异常也会导致空行识别失败。

• 本地规则被篡改：虽然你选择了Google Checks规则集，但是如果本地的Checkstyle配置文件被意外修改，调整了该检查项的默认参数，也会导致和同学的校验结果不一致。

• 排查空白字符：打开Eclipse的「窗口→首选项→常规→编辑器→文本编辑器」，勾选「显示空白字符」，删除空行内的多余空格、制表符，同时统一项目所有文件的换行符格式为同一种，避免不同系统换行符混用。
• 统一插件版本：确认老师同学使用的Checkstyle插件版本，将你本地的插件降级/升级到对应版本即可消除版本差异导致的误报。
• 重置规则配置：将你的Checkstyle规则集重置为官方默认的Google Checks配置，排除自定义规则修改导致的异常。
• 调整Javadoc缩进：确保Javadoc每一行的*都和首行/**的第二个*对齐，空行仅保留*和必要的对齐缩进，不要添加多余内容。

内容的提问来源于stack exchange，提问作者user10618607