Gradle构建的含正确Manifest的Jar无法执行求助

这种Manifest入口点找不到的问题真的挺闹心的——我之前在构建JavaFX打包程序时也踩过几乎一模一样的坑，结合你的情况，给你几个针对性的排查和解决思路：

1. 先确认Gradle配置中主类的全限定名是否正确 #

很多时候问题出在主类的名称没写全！你的主类是Main，但它一定属于某个包对吧？比如com.myapp.Main，Gradle配置里必须写完整的包名+类名，而不是只写Main。

如果是用Shadow插件构建Uber Jar，加上JavaFX模块化的特殊要求，你的Gradle配置应该类似这样（给你个可参考的完整示例）：

plugins {
    id 'java'
    id 'application'
    id 'com.github.johnrengelman.shadow' version '7.1.2'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = '17' // 换成你用的JavaFX版本
    modules = ['javafx.controls', 'javafx.fxml'] // 按需添加模块
}

application {
    // 核心：这里必须写主类的全限定名
    // 如果是模块化项目，格式是「模块名.主类全限定名」
    mainClassName = 'com.myapp.Main'
    // 非模块化项目直接写全限定名即可
}

shadowJar {
    mergeServiceFiles() // 必须加，否则JavaFX的服务加载会出问题
    manifest {
        attributes(
            'Main-Class': application.mainClassName,
            // 模块化JavaFX项目必须添加这个属性，否则启动会找不到入口
            'Module-Main-Class': application.mainClassName
        )
    }
}

2. 深度验证Manifest的实际内容 #

别只看Gradle生成的Manifest预览，直接导出实际Jar里的Manifest文件检查：
打开命令行，执行：

jar xf your-uber-jar-name.jar META-INF/MANIFEST.MF

然后打开导出的MANIFEST.MF，必须同时存在这两个属性（如果是模块化项目）：

Main-Class: com.myapp.Main
Module-Main-Class: com.myapp.Main

如果只有Main-Class没有Module-Main-Class，那JavaFX启动时就会找不到入口点——这是很多人容易忽略的细节！

3. 检查主类本身的合规性 #

确保你的Main类满足以下要求：

• 是public修饰的
• 包含public static void main(String[] args)方法，方法签名完全一致（大小写、参数都不能错）
• 如果是模块化项目，module-info.java里必须正确声明：

  module com.myapp {
      requires javafx.controls;
      requires javafx.fxml;
      
      // 必须打开主类所在的包给JavaFX模块访问
      opens com.myapp to javafx.graphics;
      // 或者直接导出包（如果需要对外暴露）
      // exports com.myapp;
      
      // 指定主类
      mainclass com.myapp.Main;
  }
  

4. 用命令行直接指定主类测试，定位问题根源 #

如果Jar还是启动不了，先绕开Manifest，直接用命令行指定主类启动：

java -cp your-uber-jar-name.jar com.myapp.Main

• 如果这样能正常启动：说明问题确实在Manifest配置上，回到前面的步骤检查Module-Main-Class属性
• 如果还是报错：说明主类本身有问题（比如依赖没正确打包进Uber Jar，或者模块声明错误）

最后总结 #

从你的描述来看，大概率是模块化JavaFX项目缺少Module-Main-Class属性，或者主类的全限定名没写对这两个原因之一。按照上面的步骤一步步排查，应该能快速解决问题。

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