Git提交触发GoogleJavaFormat报错：class, interface, or enum expected

问题核心 #

你遇到的java.lang.reflect.InvocationTargetException根源是Google Java Format工具在预提交阶段格式化代码时抛出的语法解析错误，并非代码本身的编译错误（否则项目中30处引用会直接报错）。以下是针对性的排查和解决步骤：

• 精准定位报错位置的隐性问题
  直接打开PaymentLinkUpdateDTO.java，定位到第5行第9列，检查：

  • 是否存在全角空格、制表符、不可见控制字符（可用cat -A 文件名或Notepad++显示所有字符）
  • 该行是否有注释格式错误（比如未闭合的多行注释/*）、import语句后多余的符号

• 临时验证是否为格式化钩子问题
  执行git commit --no-verify跳过预提交钩子，如果能成功提交，说明问题完全出在Google Java Format的处理逻辑上。此时可以：

  • 查看项目.git/hooks/pre-commit文件，确认是否强制调用了google-java-format，以及调用的版本
  • 手动运行格式化命令复现错误：google-java-format PaymentLinkUpdateDTO.java，获取更详细的错误输出

• 检查版本兼容性
  Google Java Format对JDK版本有要求，比如v1.10+需要JDK11及以上。如果项目使用低版本JDK，却配置了高版本的格式化工具，就会出现解析错误。可以：

  • 确认项目依赖的google-java-format版本，替换为与JDK匹配的版本
  • 用项目指定的格式化工具版本重新格式化代码

• 排查代码中的隐性语法细节
  部分语法在IDE中能正常识别，但格式化工具的解析器更严格：

  • 检查是否有重复的import语句、错误的静态导入
  • 类的修饰符是否冲突（比如abstract和final同时修饰类）
  • 尝试将PaymentLinkUpdateDTO的代码逐段复制到空白文件，每复制一段就用google-java-format格式化，定位到触发错误的代码块

• 检查项目格式化配置
  查看项目根目录是否存在.google-java-format配置文件，确认是否有自定义规则导致解析异常。同时确保IDE的格式化设置与项目配置的Google Java Format规则完全一致，避免本地格式化后的代码不符合钩子要求

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