无法运行OpenJFX非模块化Maven示例的问题求助

核心问题分析 #

报错Cannot run program "java": error=2, No such file or directory说明javafx-maven-plugin在执行时找不到java命令——虽然编译阶段正常，但运行阶段的JDK配置存在问题。

解决步骤 #

• 检查系统环境变量配置

  1. 终端执行echo $JAVA_HOME，确认输出是有效的JDK安装路径（必须是JDK，不能是JRE）。
  2. 执行echo $PATH，查看$JAVA_HOME/bin是否在PATH列表中，保证系统能全局找到java命令。
  3. 直接在终端运行java -version，如果这个命令也报错，说明系统环境变量配置错误，先修复这个问题。

• 配置Maven Toolchain指定JDK
  日志里显示Toolchain in javafx-maven-plugin null，说明插件没绑定指定的JDK，可通过以下方式配置：

  1. 在项目根目录创建toolchains.xml（或者修改用户目录下的.m2/toolchains.xml），填入以下内容（替换成你的JDK版本和路径）：

     <?xml version="1.0" encoding="UTF-8"?>
     <toolchains>
       <toolchain>
         <type>jdk</type>
         <provides>
           <version>17</version>
           <vendor>openjdk</vendor>
         </provides>
         <configuration>
           <jdkHome>/usr/lib/jvm/openjdk-17</jdkHome>
         </configuration>
       </toolchain>
     </toolchains>
     

  2. 在项目的pom.xml中，给javafx-maven-plugin添加toolchain支持：

     <plugin>
       <groupId>org.openjfx</groupId>
       <artifactId>javafx-maven-plugin</artifactId>
       <version>0.0.6</version>
       <configuration>
         <mainClass>hellofx.Main</mainClass>
         <toolchain>
           <type>jdk</type>
         </toolchain>
       </configuration>
     </plugin>
     

• 直接指定插件的java命令路径
  如果不想用toolchain，可直接在pom.xml的javafx插件配置里写死java可执行文件路径：

  <plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.6</version>
    <configuration>
      <mainClass>hellofx.Main</mainClass>
      <javaCommand>/usr/lib/jvm/openjdk-17/bin/java</javaCommand>
    </configuration>
  </plugin>
  

• 检查Maven自身使用的JDK
  执行mvn -v，查看Maven当前绑定的Java版本和路径，确保这个JDK是有效可用的。如果不符，可通过设置MAVEN_OPTS环境变量指定JDK：

  export MAVEN_OPTS="-Djava.home=/path/to/your/jdk"
  

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