配置自签SSL证书的两个Spring Boot微服务如何实现HTTPS通信？

阿华AIGC实验室

2026-5-21

嘿，我来帮你搞定这个跨微服务HTTPS调用的问题！看了你的描述和代码片段，问题主要出在两个地方，咱们一步步来解决：

问题分析

首先，你的代码里用的是http://协议，但目标微服务是运行在HTTPS端口上的，这首先就会导致连接不匹配；其次，Java的HTTP客户端（比如HttpURLConnection）默认不会信任自签的SSL证书，这也是调用失败的核心原因之一。

解决方案步骤

1. 修正URL协议（最基础的一步）

你当前的代码里写的是：

strURL = "http://" + ipAddress + ":" + portNumber + "/" + contextPath;

直接把协议改成https://，因为目标服务是HTTPS端口：

strURL = "https://" + ipAddress + ":" + portNumber + "/" + contextPath;
URL url = new URL(strURL);

这一步是基础，不然连HTTPS连接都建立不起来。

2. 处理自签证书的信任问题

浏览器可以手动信任自签证书，但Java的客户端不会自动这么做，所以需要针对开发/生产环境分别处理：

开发环境：临时绕过证书验证（仅测试用，禁止生产环境使用）

如果只是开发测试阶段，想快速搞定，可以让HttpURLConnection跳过证书和主机名验证，代码如下：

// 1. 创建信任所有证书的TrustManager
TrustManager[] trustAllCerts = new TrustManager[]{
    new X509TrustManager() {
        public X509Certificate[] getAcceptedIssuers() { return null; }
        public void checkClientTrusted(X509Certificate[] certs, String authType) {}
        public void checkServerTrusted(X509Certificate[] certs, String authType) {}
    }
};

// 2. 初始化SSL上下文
SSLContext sc = SSLContext.getInstance("SSL");
sc.init(null, trustAllCerts, new SecureRandom());
HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

// 3. 跳过主机名验证（如果证书的CN和目标IP/域名不匹配时需要）
HostnameVerifier allHostsValid = (hostname, session) -> true;
HttpsURLConnection.setDefaultHostnameVerifier(allHostsValid);

// 4. 正常创建HTTPS连接
URL url = new URL(strURL);
HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
// 后续的请求操作...

⚠️ 注意：这种方法会完全关闭SSL的安全验证，生产环境绝对不能用，会带来严重的安全风险！

生产环境：正确导入自签证书到Java信任库

这是生产环境的标准做法，让Java信任你的自签证书：

导出目标服务的自签证书：用浏览器访问目标微服务的HTTPS地址，点击地址栏的锁图标 → 查看证书 → 详细信息 → 复制到文件，选择DER格式保存。
导入证书到Java信任库：打开命令行，执行以下命令（替换路径和别名）：
```
keytool -import -alias my-microservice-cert -file /path/to/your/certificate.cer -keystore $JAVA_HOME/jre/lib/security/cacerts
```
默认信任库的密码是changeit，输入密码后确认导入即可。
重启调用方微服务：让Java加载新的信任库配置，之后再调用HTTPS接口就不会出现证书异常了。

更优雅的Spring Boot方式：用RestTemplate配置SSL

如果你的项目是Spring Boot，推荐用RestTemplate来调用接口，配置起来更灵活也更符合Spring生态：

@Bean
public RestTemplate sslRestTemplate() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException {
    // 加载信任库（这里用默认的cacerts，也可以指定自定义信任库文件）
    KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());
    trustStore.load(null, null); // 若用自定义信任库，替换为：trustStore.load(new FileInputStream("your-truststore.jks"), "password".toCharArray());

    // 构建信任自签证书的SSL上下文
    SSLContext sslContext = SSLContexts.custom()
            .loadTrustMaterial(trustStore, new TrustSelfSignedStrategy())
            .build();

    // 创建带SSL配置的HttpClient
    CloseableHttpClient httpClient = HttpClients.custom()
            .setSSLContext(sslContext)
            .build();

    // 配置RestTemplate使用这个HttpClient
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(httpClient);
    return new RestTemplate(factory);
}

之后注入这个RestTemplate，直接调用HTTPS接口即可，不用每次都处理证书问题。

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