反编译Java老项目cogito导入Eclipse的编译与运行报错求解

报错核心根因 #

• Servlet类型无法解析+token语法报错
  该项目是10多年前的传统Java Web项目，本身不包含Servlet API实现依赖；同时反编译产出的.java文件存在天然缺陷：反编译工具经常会丢失导入语句、打平内部类结构、生成无效语法片段，在没有对应依赖补全的情况下，就会同时触发“类型无法解析”和“需要删除token”的双重报错。
• AFMParser类空指针报错
  org.fontbox.afm.AFMParser是内嵌在项目依赖中的字体解析工具类，自带的main方法是设计来接收命令行传入的字体文件参数做调试用的，根本不是cogito项目的启动入口。导入项目时，Eclipse错误将这个带main方法的类识别为默认启动类，直接运行时因为没有传入任何命令行参数，存文件名的files数组为null，读取数组长度时就触发了空指针异常。
  另外把反编译的.java和原.class放在同一目录的操作，也会让Eclipse触发重复编译冲突，进一步放大这类报错。

分步可落地解决思路 #

• 修正项目导入结构
  不要将现有目录作为普通Java项目直接导入：在Eclipse中新建动态Web项目，将原项目的app目录映射为Web内容根目录，把WEB-INF/classes下的原有.class文件关联到项目类路径，将WEB-INF/lib下的所有第三方jar包全部加入项目构建路径。给项目绑定对应版本的Tomcat运行时（优先选Tomcat 7/8，匹配10多年前的Servlet规范），绑定后Servlet API会自动引入，可直接解决javax.servlet.http.HttpServletRequest无法解析的报错。
• 处理反编译代码的语法冲突
  新建独立的源码目录存放所有反编译产出的.java文件，不要将.java文件和原目录下的同名.class文件放在同一个编译路径下，避免Eclipse重复编译产生冲突。针对反编译导致的token语法报错，逐行定位无效片段：这类报错大多是反编译时丢失泛型、误生成冗余符号导致的，删除无效token、补充缺失的导入语句即可修复，可借助Eclipse的快速修复提示自动补全大部分缺失的引用。
• 修正应用启动逻辑
  不要单独右键运行带main方法的工具类启动项目：找到项目WEB-INF/web.xml中配置的Servlet入口、应用上下文，通过绑定的Tomcat服务器启动整个Web应用，从根本上避免误启动AFMParser这类工具类的问题。如果确实需要调试AFMParser，需在运行配置中手动传入对应字体文件的路径作为命令行参数，即可规避files数组为null的空指针问题。
• 版本兼容注意事项
  项目复现优先使用JDK 8及以下版本，避免高版本JDK对老类库的反射、字节码兼容问题导致的额外报错。

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