部分Java项目Jar包无法双击/命令行启动问题排查求助

以下是针对你的Jar包启动问题的具体排查步骤：

• 检查Jar包内的依赖与路径配置
  解压异常Jar包和正常Jar包，对比两者的目录结构：

  • 查看是否包含lib目录及其中的依赖Jar文件，确认依赖是否完整打包
  • 用命令 jar tf MyJarFile.jar | grep mainclass 验证主类的路径是否与全限定名一致（比如package/mainclass.class是否存在，注意Java类路径区分大小写）

• 验证Manifest文件的细节
  用命令 unzip -p MyJarFile.jar META-INF/MANIFEST.MF 导出Manifest内容，对比正常Jar的Manifest：

  • 确认Main-Class属性的全限定名完全正确（包名、类名大小写一致，无多余空格）
  • 检查Class-Path属性是否正确配置：如果依赖Jar放在外部lib目录，Class-Path需指向lib/xxx.jar，且运行时lib目录要与主Jar在同一目录；如果依赖合并到主Jar，Class-Path可能不需要配置

• 捕获完整的启动错误日志
  之前未找到异常可能是错误输出未被捕获，执行以下命令获取完整日志：

  java -jar MyJarFile.jar > startup.log 2>&1
  

  或者启用类加载详细日志，定位缺失的类：

  java -verbose:class -jar MyJarFile.jar
  

• 对比IntelliJ工件配置的细节
  打开两个项目的IntelliJ工件设置（File -> Project Structure -> Artifacts），逐一核对：

  • 检查输出布局中是否包含了项目的所有编译输出（Project compiled output是否被添加到Jar中）
  • 查看依赖的处理方式：是选择了“提取到Jar中”还是“复制到输出目录并链接”，确保与正常项目的配置一致
  • 确认Jar包的输出路径和文件名是否存在特殊字符或空格（可能导致路径解析错误）

• 检查Jar包完整性与运行环境

  • 用jar tf MyJarFile.jar列出Jar内容，若出现错误提示说明Jar包损坏，重新构建
  • 执行java -version确认运行时Java版本为8，避免高版本Java的兼容性问题

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