Spring Boot运行jar包时无法读取resources下SSL证书文件如何解决

IDE中运行时，项目编译后的class和资源文件直接存放在本地文件系统目录中，getResource()返回的是file:协议的URI，可以正常转为File对象读取。但打包成jar包后，所有资源都被封装在jar归档文件内部，getResource()返回的是jar:file:协议的URI，Java NIO无法直接将jar包内部的资源路径映射为文件系统中的File对象，因此抛出FileSystemNotFoundException异常。

方案1：证书嵌入jar包一体化部署 #

修改证书读取逻辑，不依赖File对象，直接读取资源输入流加载证书，示例代码如下：

@Bean
RestTemplate restTemplate() throws KeyManagementException, UnrecoverableKeyException, NoSuchAlgorithmException, KeyStoreException, CertificateException, IOException {
    final String password = "password";
    // 直接读取类路径下的资源流，同时兼容IDE和jar包运行场景
    try (InputStream certInputStream = getClass().getClassLoader().getResourceAsStream("static/certificate.pfx")) {
        if (certInputStream == null) {
            throw new RuntimeException("证书文件不存在，请检查路径配置");
        }
        // 调整getHttpComponentsClientHttpRequestFactory方法，接收InputStream而非文件路径
        // KeyStore.load()本身就支持InputStream参数，无需额外落地为文件
        HttpComponentsClientHttpRequestFactory factory = getHttpComponentsClientHttpRequestFactory(certInputStream, password);
        return new RestTemplate(factory);
    }
}

• 优点：部署简单，不需要额外管理证书文件，包内集成开箱即用
• 缺点：证书更新需要重新编译打包，不同环境无法灵活切换证书

方案2：证书放在外部文件系统，路径可配置 #

1. 在配置文件（application.properties/application.yml）中添加证书路径配置：

# application.properties
ssl.client-cert-path=/data/ssl/certificate.pfx
ssl.client-cert-password=password

2. 代码中注入配置，直接读取外部文件：

@Value("${ssl.client-cert-path}")
private String certPath;
@Value("${ssl.client-cert-password}")
private String certPassword;

@Bean
RestTemplate restTemplate() throws Exception {
    File certFile = new File(certPath);
    if (!certFile.exists()) {
        throw new RuntimeException("证书文件不存在，请检查路径：" + certPath);
    }
    HttpComponentsClientHttpRequestFactory factory = getHttpComponentsClientHttpRequestFactory(certFile.getAbsolutePath(), certPassword);
    return new RestTemplate(factory);
}

• 优点：证书更新、不同环境切换证书都不需要重新打包，灵活性高，符合企业级运维规范
• 缺点：部署时需要额外放置证书文件到指定路径，多了一步运维操作

如果证书几乎不会变更，且不同环境使用同一套证书，选择方案1更便捷。如果有证书定期轮换需求、或者多环境证书不同，方案2更优，是生产环境的主流选择。

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