前端时间帮朋友的公司部署一套基于SpringBoot的管理系统,对方业务负责人上来第一句话就是“接口能不能走HTTPS”。我登录服务器一看,项目还在8080端口裸奔,管理员登录密码直接明文在链路上跑,说实话,这种状态放到安全评审里就是个整改项。于是花了一个下午,把CA证书、自签名证书、HTTPS安全部署这条链路完整走了一遍,顺手把过程中踩过的坑也都记了下来。这篇博文就是那次部署的完整复盘。
你在网上搜索“SpringBoot 集成CA证书”的时候,大概率会遇到两类问题:一类是证书本身生成不对,另一类是SpringBoot版本太高和系统自带CA证书版本旧导致的兼容性报错。这篇文章会从证书选型说起,带你把自签名证书生成、SpringBoot配置、HTTP跳转、Nginx部署、客户端信任、系统CA库更新这些环节全部打通。不管你是刚入门SpringBoot的实习生,还是被HTTPS坑过好几次的后端熟练工,这套流程都可以直接抄作业。
1. 方案选型:先搞清楚为什么必须要上HTTPS
1.1 HTTP明文的风险到底有多大
很多开发者的第一反应是“我这个系统部署在内网,只有内部人访问,不上HTTPS也没事”,我只能说,这个想法真的过于乐观了。HTTP协议从设计上就没有做数据加密,请求头和请求体在网络传输过程中都是明文,等同于把内容写在明信片上交给快递员,沿途每一个经手的网点、路由器、交换机、抓包工具都能完整看到你的登录密码、Cookie、业务数据。
说得更直接一点,在同一局域网里,任何一台机器都能通过抓包工具截获其他机器的HTTP流量,ARP欺骗这类手段甚至能让流量主动拐到你面前。SpringBoot后台管理系统里,管理员登录接口的账号密码、修改配置的请求、用户手机号这类敏感数据,如果全部走明文,就等于把钥匙挂在自家大门上。所以即便只是内部系统,只要存在被事后审计的可能,传输加密都是刚需。
HTTPS在HTTP和TCP之间加了一层TLS协议,核心做了三件事:通过非对称加密协商出会话密钥,让内容加密传输;通过证书链验证服务器身份,防止连到一个冒牌站点;通过摘要和MAC机制保证数据在传输中不被篡改。而这里的“证书”,就是本篇文章的主角——CA证书和自签名证书,都隶属于这套信任体系。
1.2 自签名、CA签发、免费证书到底怎么选
搞清楚为什么要上HTTPS之后,紧接着要解决的第一个问题是“证书从哪来”。很多人一上来就问要不要自己搭建一个CA系统,我的建议是:除非你是一家成规模的企业,有专门的运维和PKI团队,否则完全没必要自己搭CA。证书的常见来源有三种,各自适用的场景完全不同。
- 自签名证书:用自己的私钥直接给自己签发,证书里的签发者(Issuer)和持有者(Subject)是同一个,没有上级CA背书。用在内网测试、开发环境、个人项目上完全够用,成本为零,几分钟就能生成。
- 企业内网CA:搭建一套私有CA体系或使用Windows AD CS,只信任内网自己的CA根证书,客户端需要预先安装根证书。适合有一定规模的企业内网。
- 公网CA证书:由浏览器和操作系统信任的公共CA签发,比如各大云厂商提供的DV证书,以及Let’s Encrypt这类免费证书。浏览器直接信任,适合对外提供服务的公网站点。
做选型的时候有一个简单原则:凡是用户用浏览器直接访问的正式环境,优先用公网CA证书;凡是内网测试、前后端联调、运维自查,就老老实实用自签名证书,别嫌它“不够正规”,很多云厂商内部的测试环境同样在用自签名证书,重点是证书信息要写对、有效期和私钥管理要规范。
1.3 部署架构:直接集成还是走Nginx反向代理
证书有了之后,还得想清楚HTTPS放在哪一层。最常见的两种架构:第一种是SpringBoot内嵌的Tomcat直接监听443或8443端口,证书配置写在application.yml里,Tomcat自己完成TLS握手;第二种是在前面放一个Nginx,由Nginx监听443端口完成SSL终结,再把解密后的HTTP请求转发给后端的SpringBoot应用。
这两种方式各有取舍。SpringBoot直连HTTPS的优点是架构简单、少一跳,适合只有一个后端服务的场景;缺点是证书和密钥都跟着应用走,换证书要重启服务,而且Tomcat处理TLS握手会额外消耗一些CPU。Nginx反代的方式是目前生产环境的主流,证书更新只需reload Nginx,后端应用完全不用感知TLS,还能顺便做负载均衡、静态资源缓存、限流,对多实例部署更友好。
我的实际建议是:如果应用要部署到公网,统一采用“Nginx终结SSL + SpringBoot内部走HTTP”的方案;如果是内网联调环境,或者你手头只有一台测试机,直接在SpringBoot里配置自签名证书就够了。下面的内容我会把两种架构各自的配置方式都写清楚,方便你按场景选取。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 证书生成:自签名证书的完整实操
2.1 环境准备与工具选择
生成自签名证书,最常用的工具是JDK自带的keytool和系统里的OpenSSL。keytool的优点是随JDK一起发布,不需要额外安装,而且生成出来就能直接用PKCS12格式放进SpringBoot;缺点是它的参数不如OpenSSL直观,很多人容易在-ext SAN这里翻车。OpenSSL则是所有证书操作的地基,PEM、CRT、KEY这些格式之间的转换全靠它,但版本太老的话有些参数不支持,建议先执行openssl version确认版本在1.1.1以上。
实际操作中,我是两把工具配合用的:先用keytool快速生成一个带SAN扩展的自签名证书用于开发和测试;一旦涉及证书格式转换、查看证书详情、或者要在Nginx上用分开的.key和.crt文件,就切到OpenSSL。下面两种生成方式都给出完整命令,你按需选择。
2.2 keytool生成含SAN的自签名证书
如果你准备让SpringBoot直接加载证书,生成一个PKCS12格式的keystore是最省事的。用keytool一条命令就能搞定:
bash复制keytool -genkeypair \
-alias myapp \
-keyalg RSA \
-keysize 2048 \
-storetype PKCS12 \
-keystore myapp.p12 \
-validity 825 \
-storepass ChangeMe123 \
-dname "CN=localhost,OU=Dev,O=MyCompany,L=Beijing,C=CN" \
-ext "SAN=DNS:localhost,DNS:api.test.com,IP:127.0.0.1"
这里每一个参数都值得细说。-alias是证书在keystore里的唯一标识,SpringBoot配置里的key-alias必须跟它一致。-keyalg RSA -keysize 2048指定了密钥算法和长度,RSA 2048是目前兼容性最好的选择,不要为了追求“更强”去用1024,也不要一上来就非得上4096,2048足够兼顾安全和性能。-storetype PKCS12指定存储格式,这是当前业界标准,老旧的JKS格式在新版本JDK里已经不被推荐。-validity 825指证书有效天数,为什么是825而不是3650我后面单独说。-dname里的CN字段是通用名称,通常填域名。最关键的是-ext "SAN=...",这里配置的就是主题备用名称,现代浏览器和Java在校验证书时只认SAN,不认CN。
命令执行过程中会提示输入两次密码,这个密码就是后续SpringBoot配置里的key-store-password。生成完可以用下面的命令确认证书信息,重点检查SAN和有效期:
bash复制keytool -list -v -keystore myapp.p12 -storepass ChangeMe123 | grep -E "Owner|Issuer|Valid|SubjectAlternative"
2.3 OpenSSL生成自签名证书并转PKCS12
如果你的部署环境是Nginx,通常需要分开的私钥文件和证书文件,这时候keytool就不太方便了,用OpenSSL更顺手。先生成私钥和自签名证书:
bash复制mkdir -p certs && cd certs
openssl req -x509 -newkey rsa:2048 -nodes \
-keyout myapp.key \
-out myapp.crt \
-days 825 \
-subj "/CN=localhost" \
-addext "subjectAltName=DNS:localhost,DNS:api.test.com,IP:127.0.0.1"
-nodes是“no DES”的缩写,表示私钥不加密,这样Nginx启动时就不用输入密码了,生产环境里私钥文件权限设成600即可。-days 825指定有效期,-subj里的/CN=localhost是主体名称,-addext同样是加SAN扩展,这一步千万别省。
如果你还想把OpenSSL生成的证书转成SpringBoot能直接读取的PKCS12文件,可以用下面的命令,注意-name的值要和你后面对应的SpringBoot别名一致:
bash复制openssl pkcs12 -export \
-in myapp.crt \
-inkey myapp.key \
-out myapp.p12 \
-name myapp \
-passout pass:ChangeMe123
2.4 证书的两个大坑:SAN和有效期
自签名证书看起来命令很简单,但实际踩坑的人非常多,十有八九栽在这两个问题上。
第一个坑是SAN。很多旧教程只让你在-dname里写CN=localhost,并没有配置-ext SAN。在2017年之后,Chrome、Firefox、Safari以及新版Java都逐步废弃了对CN字段的证书匹配校验,现在只认SAN。如果你的证书没有SAN扩展,浏览器打开HTTPS站点会直接报“证书名称不匹配”,Java客户端发起请求会报No subject alternative names matching IP address xxx found。所以无论是用keytool还是OpenSSL,生成自签名证书一定要显式加SAN,并且把你要访问的域名、IP、localhost都列进去。我测试的时候就把本地回环地址、内网IP和测试域名全部写进去了,省去了来回重新生成证书的时间。
第二个坑是有效期。我在之前生成命令里故意用了825天,这个数字是有讲究的:从2020年9月1日开始,主流CA签发的证书最长有效期被限制在398天,也就是大约13个月,各大系统对825天以上的证书会标记为“有效性过长”。自签名证书虽然不受CA政策强制约束,但如果你按这个习惯来,后续对接公网CA时流程会更顺,而且客户端对超长有效期证书的告警逻辑也容易误伤。至于那些设置3650天十年有效期的自签名证书,使用中反而会出现各种兼容性警告,得不偿失。
3. SpringBoot集成HTTPS的配置过程
3.1 把证书放进项目并调整application配置
证书生成好之后,接下来就是把证书集成进SpringBoot。这里有一个安全习惯要养成:不要把私钥和keystore提交到Git仓库,哪怕项目是私有的也不要。开发环境可以放在src/main/resources下方便联调,但生产环境我建议把证书挂在固定目录,比如/etc/myapp/ssl/myapp.p12,然后让SpringBoot通过文件路径加载。
在application.yml里做如下配置:
yaml复制server:
port: 8443
ssl:
enabled: true
key-store: file:/etc/myapp/ssl/myapp.p12
key-store-type: PKCS12
key-store-password: ${SSL_KEY_STORE_PASSWORD:ChangeMe123}
key-alias: myapp
把key-store-password用环境变量注入,是避免密码硬编码的有效手段。这里需要特别提醒的是SpringBoot版本差异:在SpringBoot 2.x里,只要检测到server.ssl.key-store配置,容器就会自动启用HTTPS,那个enabled: true写不写影响不大;但从SpringBoot 3.1开始才重新完整支持server.ssl.enabled这个开关。因此我的建议是不要依赖这个开关,而是以key-store配置是否存在为准。如果你的项目是Gradle构建,并且把证书放在src/main/resources下,要注意构建后确认证书确实被复制进了jar包,很多Gradle工程因为资源过滤配置问题导致证书没打进去,运行时会直接报找不到文件。
配置完成后启动项目,你会看到启动日志里端口变成8443,用浏览器访问https://localhost:8443就能看到SSL握手成功;如果浏览器弹出不信任提示,那是正常的,因为这是自签名证书,后面第四节讲如何解决信任问题。
3.2 支持HTTP自动跳转HTTPS
很多老用户在配置里已经习惯直接输入http://localhost:8080这种地址,上了HTTPS之后如果没做跳转,用户会一脸疑惑地发现页面打不开。生产环境里的标准做法是让HTTP端口统一跳转到HTTPS。
如果你用的是内嵌Tomcat,可以直接在SpringBoot里增加一个HTTP监听端口,并把redirectPort指向HTTPS端口。示例配置类如下:
java复制@Configuration
public class HttpsRedirectConfig {
@Bean
public TomcatServletWebServerFactory servletContainer() {
TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
factory.addAdditionalTomcatConnectors(httpConnector());
return factory;
}
private Connector httpConnector() {
Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
connector.setScheme("http");
connector.setPort(8080);
connector.setSecure(false);
connector.setRedirectPort(8443);
return connector;
}
}
这样部署后,访问http://localhost:8080时Tomcat会自动把请求转到https://localhost:8443。如果你采用Nginx反代架构,则不需要这段代码——直接让Nginx监听80并把请求return 301到HTTPS即可,后端SpringBoot只需处理HTTP。另外,如果应用跑在代理后面,一定要在application.yml里配置转发头策略,否则request.isSecure()会一直返回false,导致Spring Security里的权限校验和重定向逻辑出问题:
yaml复制server:
forward-headers-strategy: framework
3.3 开启HTTP/2与安全协议配置
配置好HTTPS之后,顺手可以再把HTTP/2打开,HTTP/2的多路复用特性对SpringBoot这种有很多并行请求的Web应用有明显增益。SpringBoot里的配置非常简单:
yaml复制server:
http2:
enabled: true
在SpringBoot 2.2+和3.x中都支持这个配置。需要说明的是,HTTP/2 over TLS依赖ALPN协议协商,如果你用的是Tomcat 9+以及近几年的JDK版本,默认就能正常工作;如果是老旧的JDK 8版本,有可能需要升级到8u252以上的补丁版本才能支持。另外,TLS协议版本方面建议只保留TLSv1.2和TLSv1.3,TLSv1.0和TLSv1.1在三年前就已经被主流浏览器和支付行业标准判定为不安全,直接在配置里禁掉:
yaml复制server:
tomcat:
ssl:
protocol: TLS
enabled-protocols: TLSv1.2,TLSv1.3
这里不建议手动去配置cipher suite列表,因为现代JDK和OpenSSL的默认列表已经足够安全,手动配置反而容易漏掉一些必要的套件,导致某些老客户端连不上。
3.4 部署在Nginx后的证书配置要点
如果你走的是“Nginx终结SSL”的经典架构,要处理的事情就变成了两边。先说Nginx这一侧,核心配置如下:
nginx复制server {
listen 443 ssl http2;
server_name api.test.com;
ssl_certificate /etc/nginx/certs/myapp.crt;
ssl_certificate_key /etc/nginx/certs/myapp.key;
ssl_protocols TLSv1.2 TLSv1.3;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
server {
listen 80;
server_name api.test.com;
return 301 https://$host$request_uri;
}
注意proxy_pass指向的是后端SpringBoot的HTTP端口8080,也就是说Nginx和SpringBoot之间是明文HTTP,这个串行通信如果也被要求加密,就得在SpringBoot侧也开启TLS,让Nginx用proxy_pass https://转发。对于普通业务场景,内网代理层到应用层之间默认不加密也是行业常见做法。
SpringBoot这一侧,因为真正和浏览器通信的是Nginx,所以SpringBoot的配置文件里不用再配置server.ssl.*,但要确保server.forward-headers-strategy: framework已经配上,同时把server.servlet.context-path和端口调整好。如果你用的是“宝塔”这类面板软件,本质也是生成Nginx配置再套一层图形界面,证书上传后选对应站点开启SSL即可,底层逻辑跟手写Nginx没有区别。
4. 客户端信任与系统CA库适配
4.1 浏览器访问自签名站点的处理
配置好HTTPS之后,自签名证书带来的下一个问题就是“浏览器不认”。这是非常正常的——浏览器的信任库是系统预装的根证书和公网CA证书,他当然不知道你随手生成的这个自签名证书是谁。此时浏览器会显示“您的连接不是私密连接”的红色拦截页。
开发阶段最简单的处理方式是点击浏览器警告页里的“高级 -> 继续前往”,临时放行。这种方式只对你的本机有效,而且每次重启浏览器后可能又要重新点一遍,非常烦人。更正规的方式是把自签名证书手动导入到操作系统的信任根证书库:Windows下双击.crt文件,选择“安装证书”,存储位置选“本地计算机”,再把它放到“受信任的根证书颁发机构”里;macOS下打开“钥匙串访问”,把证书拖入系统钥匙串并设为“始终信任”;Linux桌面环境则把证书放到系统CA目录后执行update-ca-certificates。
需要提醒的是,把自签名证书导入系统信任库是有安全代价的。从这一刻开始,这台机器会无条件信任这份私钥签发的所有证书,所以导入前务必确认证书是自己生成的,私钥没泄露过。测试环境用完后,我习惯定期清理掉不再需要的自签名根证书,别让测试证书长期躺在生产机器上。
4.2 Java客户端与JMeter的证书信任配置
很多情况下,HTTPS接口并不是给浏览器访问的,而是被另一个Java服务调用。这个时候你会发现,浏览器可以打开页面,Java程序却抛出一个让人头皮发麻的报错:
code复制PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target
原因是JVM有自己独立的信任存储,路径一般是$JAVA_HOME/lib/security/cacerts,这个文件预装了公共CA根证书,并不包含你的自签名证书。要让Java信任它,需要手动导入:
bash复制keytool -importcert -trustcacerts -noprompt \
-alias myapp \
-file myapp.crt \
-keystore "$JAVA_HOME/lib/security/cacerts" \
-storepass changeit
这里的changeit是JDK自带cacerts的默认密码,如果你之前改过,要换成自己的密码。要注意的是,往系统级cacerts里加证书会影响这台机器上所有Java进程,如果只想影响当前服务,更推荐的做法是启动时指定自定义信任库:
bash复制java -Djavax.net.ssl.trustStore=/opt/myapp/truststore.p12 \
-Djavax.net.ssl.trustStorePassword=ChangeMe123 \
-jar myapp.jar
这种方式同样适用于JMeter。用JMeter录制或压测HTTPS接口时,如果遇到证书校验失败,要么把服务端证书导入到JMeter使用的那个JDK的cacerts,要么通过-Djavax.net.ssl.trustStore给JMeter指定独立的信任库。如果使用JMeter自带的HTTP(S) Test Script Recorder,还需要在浏览器里安装JMeter自己的代理证书,二者不要混淆。
4.3 系统自带CA证书版本旧导致的信任问题与解决
这部分的坑我猜很多人搜过,网上有句话总结得很到位:“主要是系统自带的CA证书版本旧了,因为系统没更新了,所以系统CA证书补丁也不更。”这句话描述的场景是:旧服务器长期不更新系统,导致操作系统自带的CA根证书库还停留在几年前,里面缺少近几年新加入的根证书,于是用curl、wget、git或Java访问一些新签发的HTTPS站点时,系统会一直报“证书链不受信任”。
这种问题跟SpringBoot本身没有关系,但当你把SpringBoot应用部署到这种老系统上时,它就会“借尸还魂”一样冒出来。比如后端要调用某个第三方HTTPS支付接口,接口用的是新根证书签发的,JVM或系统CA库里没有这个根证书,调用直接失败。排查思路很简单:先用curl -v https://目标域名看是否报证书错误,再用openssl s_client -connect 目标域名:443 -showcerts对比证书链里缺少哪一环。
解决办法分系统层和Java层两层。系统层在Debian/Ubuntu上执行:
bash复制sudo apt-get install -y ca-certificates
sudo cp myapp.crt /usr/local/share/ca-certificates/myapp.crt
sudo update-ca-certificates
在CentOS/RHEL上执行:
bash复制sudo yum install -y ca-certificates
sudo cp myapp.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust
Java层则要单独处理。update-ca-certificates只会更新操作系统的证书库,并不会同步到JDK的cacerts文件,所以还得用前面第4.2节里的keytool -importcert命令把对应根证书导入到JVM信任库。如果是容器化部署,Dockerfile里也要加上安装ca-certificates、导入证书的步骤,并且注意JVM基础镜像的cacerts位置,很多基于eclipse-temurin镜像的项目的证书问题都出在这一步。
5. 版本差异、常见报错与排查技巧
5.1 SpringBoot 2.x和3.x的HTTPS配置差异
网上搜“springboot版本太高”相关的帖子,很多其实是升级后对配置差异不熟悉导致的。关于HTTPS配置,2.x和3.x确实有几个地方要留意。
最明显的变化是SpringBoot 3.x要求JDK 17及以上,同时包名从javax.*迁移到了jakarta.*。如果你把旧项目从2.x硬升到3.x,那些写着javax.servlet的代码会直接编译失败。不过在HTTPS这块,server.ssl.*配置项基本保持一致,主要差异是我在第3.1节说的server.ssl.enabled开关:SpringBoot 2.x早期版本里并没有这个开关,它是后来3.1才重新支持的,因为只要key-store配置存在就会自动开启TLS。
另一个容易被忽视的差异是默认的证书存储格式。SpringBoot 1.x默认使用JKS,2.x之后默认推荐PKCS12,3.x则彻底废除了对JKS新文件的默认支持。如果是从老项目升级,要检查是否还在用.jks文件,建议通过keytool -importkeystore把老keystore转成PKCS12。
总体而言,HTTPS配置本身并不挑SpringBoot版本,所谓“版本太高报错”,八成是JDK版本、cacerts库、或者依赖里javax/jakarta包路径问题。遇到报错先不要急着降版本,把堆栈第一行认真看一下,再去对照对应版本的官方配置文档。
5.2 高频报错速查表
为了让你真遇到问题时能迅速定位,我把高频报错整理成一个速查表:
| 报错信息 | 可能原因 | 解决建议 |
|---|---|---|
PKIX path building failed |
JVM或系统信任存储里没有对应CA根证书 | 用keytool把证书导入cacerts,或用-Djavax.net.ssl.trustStore指定信任库 |
No subject alternative names matching IP address xxx found |
证书没有配置SAN扩展 | 重新生成证书,在生成时添加-ext SAN=DNS:...,IP:... |
SSLHandshakeException: Received fatal alert: handshake_failure |
TLS协议版本或密钥算法不匹配 | 检查enabled-protocols是否包含TLSv1.2/1.3,密钥长度不低于2048 |
keystore password was incorrect |
keystore密码或别名错误 | 用keytool -list -v -keystore xxx.p12 -storepass xxx查看别名和密码 |
Connection reset |
Nginx与后端Tomcat的HTTP/HTTPS协议不一致 | 检查proxy_pass是http还是https,确认后端端口 |
ERR_SSL_VERSION_OR_CIPHER_MISMATCH |
浏览器与服务器支持的TLS协议无交集 | 开启TLSv1.2和TLSv1.3,避免只留过低或过高的协议 |
这张表基本覆盖了我在实操中遇到的大部分问题。遇到报错的第一时间,不要急着改配置,先确认证书本身是好的,再确认两边协议对得上,最后才查代码和依赖问题。
5.3 排查命令与一次完整的问题定位过程
最后分享一套我每次调试HTTPS都会用的三件套命令,以及一个真实遇到过的定位过程。
bash复制curl -v https://api.test.com:8443/actuator/health
openssl s_client -connect api.test.com:8443 -showcerts
keytool -list -v -keystore /etc/myapp/ssl/myapp.p12 -storepass ChangeMe123
第一次命令用来看握手是否成功、证书是否被信任、有没有证书链报错;第二次命令用来直接看服务器返回的证书详情和证书链;第三次命令用来检查keystore本身有没有问题。
有一次测试环境突然访问HTTPS接口超时,curl -v显示卡在TLS握手阶段,但同样的配置前一天还是好的。我下意识以为是证书过期,结果openssl s_client一看,证书有效期明明还有半年。再用keytool -list检查keystore,发现别名变了——原来是同事重新生成证书的时候alias随手改成了newapp,但配置文件里的key-alias还是myapp,Tomcat加载证书时找不到对应别名,整个握手就卡住了。把alias改回来之后服务立刻恢复。
这类问题其实很常见,证书文件内容看起来是对的,只是别名、密码、SAN这三处细节没对上。所以你在排查时,最好把上面三条命令的输出都拿一遍,三分钟之内基本能定位出问题所在。
6. 实操心得与部署后的自检清单
6.1 证书轮换与私钥管理要提前想清楚
很多团队第一次做完HTTPS部署就觉得万事大吉,结果证书到期那天全员手忙脚乱。自签名证书有效期设置再长也有到期的一天,公网免费证书更是只有90天有效期,所以证书轮换机制必须提前设计。
我的经验是:把证书相关文件统一放到一个目录,比如/etc/myapp/ssl/下,并用myapp.p12.当前日期这种命名方式保留历史版本;配置里的密码统一从环境变量读取;配合监控系统对证书有效期做告警,到期前30天、7天、1天分别提醒一次。对于Nginx场景,换证书只需把新证书替换后执行nginx -s reload,并不用重启SpringBoot;对于SpringBoot直连场景,才需要重启应用加载新的keystore。
私钥文件的权限同样不能忽视。生成出来的.key文件默认权限通常是644,别人可读,这等于把大门钥匙放在门口。生产环境务必执行chmod 600 myapp.key,并确认只有运行应用的用户才能读文件。如果是P12文件,也要保持在600或640权限。另外建议所有密码不要直接写在application.yml里,至少通过环境变量注入,有条件的话用配置中心管理。
6.2 部署后的最终自检清单
按照完整流程走完部署之后,不要急着走人。我会固定按照下面这份清单做最后的自检,你也完全可以照搬。
先检查证书本身:用openssl s_client确认证书链完整、SAN覆盖所有访问域名、有效期充足。再检查SpringBoot侧配置:server.ssl.key-store路径存在、别名正确、密码通过环境变量注入、forward-headers-strategy已配置。接着检查HTTP跳转:直接访问http://地址应该301到https://,Nginx场景检查80端口server块配置。还需要检查客户端信任:浏览器无拦截访问成功、Java代码能正常调用、JMeter脚本不会报证书错误。最后检查安全项:TLS版本至少是TLSv1.2、HTTP/2已启用、私钥文件权限600、旧证书文件已清理、系统CA证书库已更新。
这套流程走完,基本不会有什么隐藏问题。我在实际操作里发现,每次换证书或者换服务器,重新走一遍这个清单比凭记忆东查西查快得多。建议把这篇文章里的生成命令和自检清单保存成自己的运维脚本,下次直接用就行,能省下大量踩坑时间。
