NetBeans21中JavaFX21 Maven项目调试失败问题求助

问题描述 #

在NetBeans 21环境下，原基于JDK 1.8、Maven开发的JavaFX富客户端应用，升级至OpenJDK 21与JavaFX 21后可正常运行，但调试功能失效。

POM中javafx-maven-plugin配置 #

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <executions>
        <execution>
            <!-- Default configuration for running -->
            <id>default-cli</id>
            <configuration>
                <mainClass>ch.xyz.portal.MainApp</mainClass>
            </configuration>
        </execution>
        <execution>
            <!-- Configuration for debugging -->
            <id>debug</id>
            <configuration>
                <options>
                    <option>-agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=*:8000</option>
                </options> 
                <mainClass>ch.xyz.portal.MainApp</mainClass>
            </configuration>
        </execution>
    </executions>
</plugin>

NetBeans调试动作配置 #

<action>
    <actionName>debug</actionName>
    <goals>
        <goal>clean</goal>
        <goal>javafx:run</goal>
    </goals>
        <properties>
        <exec.args></exec.args>
        <exec.vmArgs>-agentlib:jdwp=transport=dt_socket,server=n,suspend=n,address=8000 --module-path C:/Programme/Java/Temurin/lib --add-modules javafx.controls,javafx.fxml</exec.vmArgs>
    </properties>
</action>

调试启动错误日志 #

[DEBUG] Executing command line: [C:\Programme\Java\Temurin\bin\java.exe, -agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=*:8000, ch.xyz.portal.MainApp]
ERROR: transport error 202: connect failed: Cannot assign requested address
ERROR: JDWP Transport dt_socket failed to initialize, TRANSPORT_INIT(510)
JDWP exit error AGENT_ERROR_TRANSPORT_INIT(197): No transports initialized [s\src\jdk.jdwp.agent\share\native\libjdwp\debugInit.c:700]
[ERROR] Command execution failed.
org.apache.commons.exec.ExecuteException: Process exited with an error: 2 (Exit value: 2)

原因分析 #

1. JDWP模式与地址格式不匹配：POM中debug执行配置使用server=n（客户端模式），但同时指定address=*:8000——*是服务器模式（server=y）下监听所有网卡的格式，客户端模式需明确指定调试服务器地址（如localhost:8000），格式错误导致无法建立连接。
2. 配置重复冲突：NetBeans调试动作重复定义JDWP参数和JavaFX模块路径，而javafx-maven-plugin已负责处理模块依赖，重复配置干扰命令行参数生成，且实际执行优先使用了POM中错误的JDWP配置。
3. 角色逻辑颠倒：调试场景下通常IDE作为JDWP客户端，应用作为JDWP服务器等待连接，当前配置将应用设为客户端，试图连接不存在的调试服务器，导致连接失败。

解决步骤 #

1. 修正POM中JDWP配置为服务器模式 #

修改javafx-maven-plugin的debug执行配置，将JDWP模式设为服务器端，确保地址格式正确：

<execution>
    <!-- Configuration for debugging -->
    <id>debug</id>
    <configuration>
        <options>
            <option>-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=*:8000</option>
        </options> 
        <mainClass>ch.xyz.portal.MainApp</mainClass>
    </configuration>
</execution>

• server=y：将应用设为JDWP服务器，等待IDE连接
• suspend=y：启动时暂停，直到IDE连接后再继续，方便调试入口代码
• address=*:8000：监听所有网卡的8000端口，确保IDE可以连接

2. 清理NetBeans调试动作的重复配置 #

修改NetBeans的调试动作，直接调用POM中定义的debug执行ID，并清空重复的VM参数：

<action>
    <actionName>debug</actionName>
    <goals>
        <goal>clean</goal>
        <goal>javafx:run@debug</goal> <!-- 调用POM中id为debug的execution -->
    </goals>
    <properties>
        <exec.args></exec.args>
        <exec.vmArgs></exec.vmArgs> <!-- 移除重复配置，由plugin提供参数 -->
    </properties>
</action>

3. 验证端口可用性 #

检查8000端口是否被其他进程占用，若被占用可修改端口（如改为8001），确保POM和IDE调试配置中的端口一致。

4. 确认NetBeans调试器设置 #

在NetBeans中打开调试器配置，确保调试器的连接地址为localhost:8000，端口与POM配置一致。

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