javafx-maven-plugin排除依赖解决跨平台fat jar运行报错问题

根本不需要维护两套独立的pom文件，这个问题是Maven依赖作用域和插件类路径隔离的常规场景，两种成熟方案可以直接用：

方案1：插件级依赖隔离（优先推荐，无额外操作成本） #

javafx:run 报no suitable pipeline found的核心原因是：你把三个平台的native依赖放在了全局依赖列表里，开发运行时类路径同时存在多份平台原生图形库，JavaFX启动时无法匹配当前系统的正确渲染管线，直接初始化失败。

maven-shade-plugin支持声明插件专属依赖，这部分依赖只会在插件执行时被解析，完全不会进入开发阶段的编译、运行类路径，刚好匹配你的需求：

• 先把全局<dependencies>里三个带win/linux/mac分类器的javafx-graphics依赖全部删掉，保留日常开发的JavaFX常规依赖即可，先验证mvn javafx:run可以正常启动，没有报错。
• 在maven-shade-plugin的配置块内部，添加三个平台的javafx-graphics依赖作为插件自身的依赖，shade打包时会自动把这部分依赖和项目全局依赖一起合并进fat jar，不会影响开发时的类路径。

参考配置如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.1</version>
    <!-- 仅shade插件可见的依赖，开发运行时不会加载 -->
    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-graphics</artifactId>
            <version>${javafx.version}</version>
            <classifier>win</classifier>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-graphics</artifactId>
            <version>${javafx.version}</version>
            <classifier>linux</classifier>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-graphics</artifactId>
            <version>${javafx.version}</version>
            <classifier>mac</classifier>
        </dependency>
    </dependencies>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <!-- 原有shade配置，比如主类声明、资源转换器等保持不变 -->
            </configuration>
        </execution>
    </executions>
</plugin>

这个方案不需要切换任何命令、不需要激活profile，日常开发直接跑javafx:run完全感知不到打包用的多平台依赖，不会出现类冲突；执行mvn package时自动把全平台原生库打进fat jar，直接实现跨平台运行。

方案2：Maven Profile场景隔离 #

如果因为shade插件版本兼容问题，插件内依赖无法被正常打进jar，可以用Maven的profile机制做场景拆分：

• 默认激活开发profile，这个profile里只保留当前开发环境需要的JavaFX依赖，不引入多平台分类器依赖，保证javafx:run正常运行
• 单独定义打包专用profile，在这个profile的依赖列表里加入三个平台的javafx-graphics依赖，打包跨平台jar时执行mvn package -Pbuild-cross-platform-jar即可，开发时不激活这个profile就不会有类路径冲突。

参考配置片段：

<profiles>
    <!-- 开发环境默认激活，无多平台依赖 -->
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <!-- 原有开发依赖全部保留，不要加三个平台的javafx-graphics -->
    </profile>
    <!-- 打包跨平台fat jar时手动激活 -->
    <profile>
        <id>build-cross-platform-jar</id>
        <dependencies>
            <!-- 把三个带win/linux/mac分类器的javafx-graphics依赖放在这里 -->
        </dependencies>
    </profile>
</profiles>

注意：不要尝试通过Maven默认的依赖scope（compile/provided/runtime等）实现这个需求，没有任何原生scope支持"仅package阶段对特定插件可见"的效果，要么会把依赖漏进开发运行类路径导致冲突，要么打包时不会被shade包含进fat jar。

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