IntelliJ构建JavaFX 12 Artifact提示无主清单属性但实际存在？

我完全懂你现在的纠结——明明克隆的IntelliJ Gradle非模块化HelloFX示例能正常构建运行，用Add -> JAR -> from modules with dependencies...生成Artifact后，运行JAR却弹出no main manifest attribute的错误，而且你明明确认清单文件里有Main-Class属性，这种矛盾的情况确实让人头大。

下面是几个针对性的排查和解决步骤，你可以逐一尝试：

• 检查清单文件的位置与格式细节
  有时候IntelliJ生成的清单文件可能没被正确打包到JAR的META-INF/MANIFEST.MF路径下，或者格式有隐性问题。你可以手动解压生成的JAR包，查看META-INF目录下的MANIFEST.MF是否存在，同时确认Main-Class行的格式是否严格正确：

  Main-Class: com.yourpackage.MainClass
  注意冒号后面必须有一个空格，且行尾不能有多余空格或异常换行。

• 重新调整Artifact的构建配置
  大概率是配置Artifact时，清单文件的引用环节出了问题。你可以重新走一遍配置流程：

  1. 打开File -> Project Structure -> Artifacts
  2. 选中你创建的JAR Artifact，在右侧Output Layout面板找到META-INF/MANIFEST.MF
  3. 确保它指向的是正确的清单文件（而非自动生成的空文件），如果有问题，点击Create Manifest重新生成，生成时务必指定正确的主类
  4. 勾选Include in project build选项，保证构建时清单文件被正确打包进JAR

• 改用Gradle原生任务构建可执行JAR
  既然是Gradle项目，其实完全可以绕开IntelliJ的Artifact功能，直接用Gradle配置生成可靠的可执行JAR。在build.gradle里添加以下配置：

  plugins {
      id 'application'
      id 'org.openjfx.javafxplugin' version '0.0.13'
  }
  
  javafx {
      version = '21' // 替换成你实际使用的JavaFX版本
      modules = ['javafx.controls', 'javafx.fxml']
  }
  
  mainClassName = 'com.yourpackage.MainClass' // 替换成你的主类全限定名
  
  jar {
      manifest {
          attributes 'Main-Class': mainClassName
      }
      from {
          configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
      }
  }
  

  之后在终端执行./gradlew jar（Windows环境用gradlew.bat jar），生成的可执行JAR会在build/libs目录下，直接运行java -jar build/libs/your-jar-name.jar就能正常启动。

• 清理缓存后重新构建
  有时候IntelliJ的缓存会引发一些莫名其妙的问题，你可以试试：

  1. 执行File -> Invalidate Caches... -> Invalidate and Restart
  2. 删除项目根目录下的out和build文件夹
  3. 重新构建项目并生成Artifact

这些方法应该能帮你解决问题，不少遇到同款情况的开发者都是通过调整清单配置或改用Gradle原生任务搞定的。

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