Bitbucket Pipelines构建失败，添加构建状态徽章遇JavaFX依赖问题

你在Bitbucket Pipelines跑JavaFX项目构建时遇到的这个报错，其实是个挺常见的环境差异问题——同样的项目在Travis CI能正常构建，到Bitbucket就卡壳，核心原因是两者默认的JDK环境不一样：

Travis CI大概率用的是包含JavaFX组件的Oracle JDK，或者配置了带JavaFX的镜像；但Bitbucket Pipelines默认的openjdk:8镜像是精简版OpenJDK，本身不包含JavaFX的jfxrt.jar，所以Maven找不到这个依赖就直接报错了。

给你几个按推荐程度排序的解决方案：

1. 切换到自带JavaFX的JDK镜像 #

最省心的办法就是换个包含JavaFX的JDK镜像，比如Azul Zulu的OpenJDK发行版——它默认就带JavaFX，完美适配Java 8。修改你的bitbucket-pipelines.yml配置如下：

image: azul/zulu-openjdk:8

pipelines:
  default:
    - step:
        script:
          - mvn clean install

替换镜像后重新触发构建，基本能直接解决问题。

2. 手动将jfxrt.jar安装到Maven本地仓库 #

如果不想换镜像，可以在Pipeline脚本里手动把jfxrt.jar安装到Maven仓库。你可以先把对应版本的jfxrt.jar放到项目目录（比如./lib下），然后在构建前执行安装命令：

mvn install:install-file -Dfile=./lib/jfxrt.jar -DgroupId=javafx -DartifactId=jfxrt -Dversion=1.8 -Dpackaging=jar

把这个命令加到Pipeline脚本的最前面，示例配置：

image: openjdk:8

pipelines:
  default:
    - step:
        script:
          - mvn install:install-file -Dfile=./lib/jfxrt.jar -DgroupId=javafx -DartifactId=jfxrt -Dversion=1.8 -Dpackaging=jar
          - mvn clean install

3. 调整pom.xml的依赖配置 #

如果项目用Maven管理，也可以直接在pom.xml里添加OpenJFX的官方依赖，替代原来的jfxrt依赖：

<dependencies>
    <!-- 保留你原有的其他依赖 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>8.0.202</version>
    </dependency>
</dependencies>

注意版本要和你项目用的Java 8匹配，这个方案不需要修改CI配置，但得确保pom.xml的依赖配置正确。

建议先试第一个方案，换Zulu镜像，这是最快解决问题的方式。如果还有问题，再检查下Pipeline脚本的执行顺序或者pom.xml的依赖细节。

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