IntelliJ中JavaFX项目添加JFoenix组件触发Application启动方法异常问题求助

Root Cause #

The NoClassDefFoundError you're hitting comes down to a critical version mismatch between JFoenix and your JavaFX setup:

• The JFoenix 8.0.10 you’re using was built exclusively for JavaFX 8, and it relies on internal JavaFX APIs like com.sun.javafx.css.StyleConverterImpl. These internal APIs were locked down or removed entirely in JavaFX 11+ (including your JavaFX 17 environment), so the runtime can’t locate the class when trying to initialize the JFXButton.
• To make things worse, your launch command mixes Maven-managed JavaFX 17.0.1 dependencies with a local JavaFX SDK 17.0.2, creating unnecessary dependency conflicts that amplify the issue.

Step-by-Step Solutions #

1. Switch to a JavaFX 11+ Compatible JFoenix Version

Use a JFoenix release built for modern JavaFX versions. The most reliable pick is 9.0.10 — it works seamlessly with JavaFX 11 through 17.

If you’re using Maven, update your pom.xml with this dependency:

<dependency>
    <groupId>com.jfoenix</groupId>
    <artifactId>jfoenix</artifactId>
    <version>9.0.10</version>
</dependency>

2. Standardize JavaFX Dependency Versions

Ensure all your JavaFX dependencies use the same version, and stick to Maven Central dependencies instead of mixing with a local SDK. Update your pom.xml dependencies section:

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>17.0.2</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>17.0.2</version>
    </dependency>
</dependencies>

3. Adjust Module Configuration (If Using a Modular Project)

If your project uses Java modules (has a module-info.java), add a requirement for JFoenix to your module descriptor:

module com.cjc.aidre.csjavafx {
    requires javafx.controls;
    requires javafx.fxml;
    requires com.jfoenix;
    exports com.cjc.aidre.csjavafx;
}

4. Clean and Rebuild Your Project

• Delete the target directory to wipe old compiled files and cached dependencies
• Run mvn clean compile to refresh dependencies and recompile the project from scratch

Verify the Fix #

After making these changes, re-run your application. The JFXButton should load without throwing the NoClassDefFoundError, and your Material UI test should work as expected.

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