VSCode中JavaFX项目运行报错：找不到主方法求助

问题现象 #

• 新建或使用VSCode生成的默认JavaFX项目，运行时均报错：Error: Main method not found in the file, please define the main method as: public static void main(String[] args)，但代码中已正确定义main方法
• 收到pom.xml更新提示，更新后问题仍未解决
• 已尝试操作：修改pom.xml版本为最新、关闭重启项目、执行mvn clean install和mvn clean命令；使用互联网过滤器并放行相关域名，且此前能正常运行项目

提供的代码 #

Java主类代码 #

//这是VSCode为JavaFX文件生成的默认代码。
//报错信息为："Error: Main method not found in the file,
//please define the main method as: public static void main(String[] args)"

package com.example;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

import java.io.IOException;

/**
 * JavaFX App
 */
public class App extends Application {
     private static Scene scene;
     @Override
     public void start(Stage stage) throws IOException {
        scene = new Scene(loadFXML("primary"), 640, 480);
        stage.setScene(scene);
        stage.show();
     }

     static void setRoot(String fxml) throws IOException {
         scene.setRoot(loadFXML(fxml));
     }

     private static Parent loadFXML(String fxml) throws IOException {
         FXMLLoader fxmlLoader = new FXMLLoader(App.class.getResource(fxml + ".fxml"));
         return fxmlLoader.load();
     }

     public static void main(String[] args) {
         launch();
     }

}

pom.xml配置 #

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
   <modelVersion>4.0.0</modelVersion>
      <groupId>com.example</groupId>
      <artifactId>demo</artifactId>
      <version>1.0-SNAPSHOT</version>
      <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.source>11</maven.compiler.source>
         <maven.compiler.target>11</maven.compiler.target>
      </properties>
      <dependencies>
         <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>13</version>
         </dependency>
         <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>13</version>
         </dependency>
      </dependencies>
      <!-- ... -->
</project>

排查与修复建议 #

1. 检查VSCode运行配置

   • 打开运行和调试面板，确认启动配置中的mainClass是否正确指向com.example.App，避免配置错误导致找不到主类
   • 若用Maven插件运行，检查maven exec:java目标的配置，确保指定正确的主类全限定名

2. 验证版本兼容性

   • 当前pom.xml指定Java 11搭配JavaFX 13，虽兼容但建议统一为LTS版本（如Java 17+JavaFX 17），稳定性更高
   • 执行java -version和mvn -v，确认终端使用的Java版本与pom.xml中maven.compiler.source/target一致，避免环境版本冲突

3. 检查编译输出

   • 查看项目target/classes目录，确认com/example/App.class是否存在。若不存在，说明编译失败，需查看Maven编译日志的错误信息
   • 若编译失败，可删除本地Maven仓库的org/openjfx目录后重新执行mvn clean install，强制重新下载依赖

4. 处理VSCode插件与缓存

   • 禁用并重新启用Java相关插件（如Language Support for Java、Maven for Java、JavaFX Support），再重启VSCode
   • 删除项目根目录下.vscode文件夹中的settings.json和launch.json，重新生成运行配置

5. 补充JavaFX Maven插件配置
   当前pom.xml缺少JavaFX运行所需的插件配置，这很可能是核心问题，补充如下配置到pom.xml的<build>节点中：

   <build>
       <plugins>
           <plugin>
               <groupId>org.openjfx</groupId>
               <artifactId>javafx-maven-plugin</artifactId>
               <version>0.0.8</version>
               <executions>
                   <execution>
                       <id>default-cli</id>
                       <configuration>
                           <mainClass>com.example.App</mainClass>
                       </configuration>
                   </execution>
               </executions>
           </plugin>
       </plugins>
   </build>
   

6. 验证互联网过滤器影响
   临时关闭过滤器，重新执行mvn clean install，确认是否存在隐藏的依赖下载失败问题

内容的提问来源于stack exchange，提问作者Mrs. A KF