最近在做一个对外数据对接项目,对方安全审计要求所有外部接口必须走HTTPS,否则不给开通网络策略。我手里是一个基于Spring Boot的服务,之前一直跑在HTTP上,本以为改个配置就行,结果从证书生成、密钥库格式、Tomcat连接器配置,到客户端调用时的证书信任问题,一路踩了不少坑。这篇文章就把我完整走通的方案记录下来,覆盖Spring Boot发布HTTPS服务的完整链路:证书怎么生成、服务端怎么配、客户端怎么调、双向认证怎么做,以及线上最容易踩的坑。无论你是第一次接触HTTPS还是已经配过但遇到过诡异问题,这篇都能给你一个可以直接落地的参考。
1. 先想明白:HTTPS在Spring Boot里到底改了什么
1.1 一个真实场景把我逼到了HTTPS
有次在某个数据交换项目的联调现场,对方运维丢过来一句话:你们的接口如果是HTTP,我们这边直接给拦截掉。当时服务已经开发完,前端页面、内部调用全走HTTP,临时要改成HTTPS,最怕的就是改完启动不起来,或者客户端全部报SSL握手失败。
实际上Spring Boot切HTTPS并不复杂,核心就三件事:一个合法的证书(包含私钥)、正确的SSL配置、客户端对证书的信任。但这三件事每一件都有不少隐藏细节,尤其在证书格式、密钥库类型、JDK版本这几个交叉点上。
1.2 HTTPS握手简化和证书的关键作用
HTTPS的本质是HTTP跑在TLS/SSL协议之上。握手过程大致分五步:
- 客户端发起ClientHello,携带支持的TLS版本、加密套件列表
- 服务端返回ServerHello,选定加密套件,并下发证书
- 客户端验证证书合法性(信任链、有效期、域名匹配)
- 双方通过非对称加密协商出会话密钥
- 后续通信全部使用对称加密
也就是说,服务端只需要持有证书和私钥,就能完成握手。证书的作用是证明"我是谁",私钥的作用是证明"我确实持有这个证书对应的身份"。这就像身份证加钥匙的配合关系。
1.3 单向认证与双向认证的区别
这里先说清楚一个容易混淆的概念。默认的HTTPS是单向认证:客户端验证服务端的证书,但服务端不验证客户端是谁。所谓"只要服务端有证书就行"就是指这种模式。
双向认证(mTLS)则是服务端也要求客户端出示证书,两端互相验证。这在企业间API对接、内部服务间通信、物联网设备接入等场景很常见。先从单向做起,跑通了再升级双向,不要一上来就搞mTLS,排查问题时会多一层干扰。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 证书准备:自签名还是CA证书,keytool命令里的门道
2.1 自签名和CA证书怎么选
先回答一个最常见的疑问:开发环境和内网环境能不能用自签名证书?
分情况看。如果调用方是Java程序,自签名证书导入对方的信任库即可,完全可行。如果调用方是浏览器或手机App,浏览器会直接拦截,因为自签名证书不在系统信任链里。如果是对外提供服务的生产环境,建议直接用公共CA签发的证书,现在申请免费证书的地方很多,某云厂商都能一键签发,证书文件一般包含公钥证书和私钥文件。
内网环境完全可以用自签名,但建议用组织内部CA去签发,而不是每个服务自己生成一个自签名证书。内部CA的好处是只需把CA根证书导入所有客户端的信任库,之后签发的所有服务端证书都自动被信任,不用每上一个服务就去改客户端配置。
2.2 用keytool生成自签名证书(PKCS12格式)
JDK自带的keytool工具足够完成证书生成。命令如下:
bash复制keytool -genkeypair -alias server -keyalg RSA -keysize 2048 -validity 3650 \
-keystore server.p12 -storetype PKCS12 -storepass changeit \
-dname "CN=localhost, OU=Dev, O=Internal, L=Beijing, ST=Beijing, C=CN"
这里重点说明几个参数:
-alias server:密钥库里的条目名称,一个密钥库可以放多对证书,通过alias区分-keyalg RSA -keysize 2048:密钥算法和长度。RSA 2048是目前的主流底线,4096更安全但握手性能差一些,内网用2048足够-validity 3650:有效期10年。自签名证书可以给长一点,CA签发的证书一般只有1年-storetype PKCS12:密钥库格式,强烈建议用PKCS12,理由后面说-dname:证书主体信息。CN字段尤其关键,客户端校验时会检查证书的CN或SAN(Subject Alternative Name)是否匹配访问的域名
生成后可以用下面命令查看证书内容,确认无误:
bash复制keytool -list -v -keystore server.p12 -storepass changeit
2.3 JKS与PKCS12:选错格式的惨痛教训
密钥库格式最容易踩坑。JDK 8以下默认是JKS,JDK 9开始默认改成PKCS12。这两者最大的区别是:
| 对比项 | JKS | PKCS12 |
|---|---|---|
| 所属生态 | Java专有格式 | 通用标准格式(.p12/.pfx) |
| 跨语言友好度 | 差,只有Java能用 | 好,Java、OpenSSL、Nginx、其他语言都能用 |
| 私钥保护 | 较弱 | 较强 |
| JDK 9+默认 | 不再默认使用 | 默认格式 |
我之前在某个项目里用JKS格式配置,后来要交给Nginx做负载均衡,Nginx根本读不了JKS,又用openssl重新转了一遍,纯属给自己找麻烦。所以新项目从一开始就用PKCS12,别再用JKS。如果你的集成方要求的是PEM格式(证书和私钥分开的文件),用keytool导出即可:
bash复制# 导出证书(公钥部分)
keytool -exportcert -alias server -keystore server.p12 -storepass changeit -rfc -file server.crt
# 导出私钥需要借助openssl,keytool不直接支持导出私钥
openssl pkcs12 -in server.p12 -nocerts -
