如何在JavaFX可执行Jar中集成Confluence SSL信任库供他人使用？

你之前直接用System.setProperty指定本地文件路径的方式，打包后肯定行不通——Jar里的资源属于压缩包内的内容，不是文件系统里的独立文件，没法用路径直接访问。把信任库放到resources目录是正确的方向，但得用动态加载证书到SSL上下文的方式，而非依赖系统属性。下面是具体实现步骤：

1. 正确放置信任库资源 #

把truststore.jks放到src/main/resources目录下，用Maven/Gradle默认配置构建打包时，这个文件会自动被打包到Jar包的根路径下。

2. 动态加载信任库到SSL上下文 #

不要依赖javax.net.ssl.trustStore系统属性，手动加载信任库并创建自定义SSL上下文，再给Confluence API客户端单独指定这个上下文。示例代码如下：

import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManagerFactory;
import java.io.InputStream;
import java.security.KeyStore;

public void initializeConfluenceSsl() throws Exception {
    // 从Jar包的resources中加载信任库
    try (InputStream tsStream = getClass().getResourceAsStream("/truststore.jks")) {
        if (tsStream == null) {
            throw new IllegalArgumentException("未找到内嵌的truststore.jks文件");
        }

        // 初始化KeyStore并加载信任库
        KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());
        // 替换为你的信任库密码，无密码则传空字符串
        trustStore.load(tsStream, "your-ts-password".toCharArray());

        // 初始化信任管理器工厂
        TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
        tmf.init(trustStore);

        // 创建自定义SSL上下文
        SSLContext sslContext = SSLContext.getInstance("TLS");
        sslContext.init(null, tmf.getTrustManagers(), null);

        // 将该SSL上下文配置给Confluence API客户端
        // 示例：若用Atlassian官方Confluence Java Client
        // ConfluenceClient client = ConfluenceClient.newBuilder()
        //     .baseUrl("https://your-confluence-domain")
        //     .sslContext(sslContext)
        //     .build();
        // 若用Apache HttpClient：
        // CloseableHttpClient httpClient = HttpClientBuilder.create()
        //     .setSSLContext(sslContext)
        //     .build();
    }
}

调用时机：在初始化Confluence API客户端之前执行，比如JavaFX控制器的initialize方法开头。

3. 不推荐全局替换SSL上下文的原因 #

如果直接把自定义SSL上下文设为全局默认（SSLContext.setDefault(sslContext)），会影响应用内所有HTTPS请求，可能导致其他第三方服务的SSL验证失败。仅给Confluence客户端单独配置上下文，安全性和兼容性更好。

4. 打包验证 #

打包完成后，用压缩工具打开Jar包，确认truststore.jks在根目录下。Maven的maven-resources-plugin、Gradle的processResources任务默认都会包含resources目录下的文件，无需额外配置。

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