在Spring Boot中启用HTTPS访问，核心在于将SSL证书文件（如JKS或PFX格式）放入项目资源目录，并在application.yml配置文件中指定证书路径、类型及密码，同时通过端口映射将HTTP重定向至HTTPS。
随着网络安全标准的日益严格,搜索引擎对HTTPS的偏好已成为行业共识，对于开发者而言，配置SSL证书不再是一个可选项，而是生产环境部署的必答题，许多新手在初次接触时，往往被复杂的证书链和密钥管理搞得晕头转向，只要理清思路，Spring Boot提供的自动化配置机制能让这一过程变得异常简单。
Spring Boot配置SSL证书启用https访问的具体步骤
配置过程主要分为证书准备、配置文件修改以及验证测试三个阶段，我们将重点放在最通用的YAML配置方式上，这是目前业界最推荐的实践方案。
第一步：获取并转换证书文件
在开始编码之前,你需要从证书颁发机构（CA）获取证书，通常你会收到一个包含公钥和私钥的压缩包，格式可能是PEM、CRT或KEY，Spring Boot原生支持两种主要格式：JKS（Java KeyStore）和PKCS12（.p12或.pfx）。
- 推荐格式：目前业界普遍推荐使用PKCS12格式，因为它兼容性更好，且是Java 9+的默认密钥库格式。
- 转换工具：如果你持有的是PEM格式的证书，可以使用OpenSSL工具进行转换，将PEM转换为PFX的命令如下：
openssl pkcs12 -export -out keystore.p12 -inkey private.key -in certificate.crt -certfile ca.crt
执行此命令后，系统会提示你设置一个导出密码，请务必牢记这个密码，因为它将用于后续的配置。
第二步：放置证书文件
将转换好的证书文件（例如keystore.p12）复制到Spring Boot项目的src/main/resources目录下，这样做的目的是确保在打包成JAR文件时，证书会被包含在最终的构建产物中，方便部署到任何服务器环境，而无需关心服务器本地的文件路径。
第三步：修改application.yml配置
这是最关键的一步,你需要在application.yml文件中添加
server.ssl相关的配置项，以下是一个标准的配置示例：
server:
port: 8443
ssl:
enabled: true
key-store: classpath:keystore.p12
key-store-password: your_password
key-store-type: PKCS12
key-alias: tomcat
让我们逐一解析这些参数的含义：
- server.port：指定HTTPS服务的监听端口，默认情况下，HTTPS使用443端口，但在开发环境或容器化部署中，使用8443或其他非特权端口更为常见。
- key-store：指定证书文件的路径，使用
classpath:前缀表示文件位于类路径下，即刚才放入resources目录的文件。 - key-store-password：证书文件的访问密码，注意，这里填写的是你在转换证书时设置的密码，而不是私钥的密码。
- key-store-type：密钥库的类型，如果是
.p12或.pfx文件，填写PKCS12；如果是.jks文件，填写JKS。 - key-alias：密钥别名，对于大多数CA颁发的证书，别名通常是
tomcat或1，如果不确定，可以查看证书详情或使用keytool命令查询。
进阶配置：强制HTTPS重定向
仅仅启用HTTPS还不够,你还需要确保所有HTTP请求都被自动重定向到HTTPS，这可以通过配置server.compression或自定义TomcatServletWebServerFactory来实现，在较新的Spring Boot版本中，可以通过以下配置实现自动重定向：
server:
servlet:
session:
cookie:
secure: true
encoding:
enabled: true
或者在Java配置类中：
@Bean
public TomcatServletWebServerFactory tomcatServletWebServerFactory() {
TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory() {
@Override
protected void postProcessContext(Context context) {
SecurityConstraint securityConstraint = new SecurityConstraint();
securityConstraint.setUserConstraint(&qu
ot;CONFIDENTIAL");
SecurityCollection collection = new SecurityCollection();
collection.addPattern("/");
securityConstraint.addCollection(collection);
context.addConstraint(securityConstraint);
}
};
return tomcat;
}
Spring Boot配置SSL证书启用https访问常见问题解析
在实际操作中,开发者经常会遇到各种棘手的问题，以下是几个高频场景的解决方案。
如何调试SSL证书配置错误？
如果应用启动失败,通常是因为证书路径错误、密码错误或文件格式不兼容。
- 检查路径：确认
classpath:后的文件名是否正确，区分大小写。 - 检查密码：确认密码是否包含特殊字符，如果在YAML中使用了特殊字符，需要用引号包裹。
- 查看日志：Spring Boot会在启动时打印详细的错误堆栈，重点关注
KeyStoreException或NoSuchAlgorithmException等异常信息。
多环境下的证书管理策略
在生产环境中,开发、测试和生产环境通常使用不同的证书，硬编码证书路径和密码是不安全的做法。
- 使用环境变量：将密码和路径通过环境变量传入。
- 使用配置文件占位符：在
application.yml中使用${SSL_PASSWORD}这样的占位符，并在启动时通过--spring.ssl.key-store-password=xxx参数传入。 - 利用Spring Profiles：为不同环境创建不同的配置文件，如
application-dev.yml、application-prod.yml，并在其中定义不同的证书路径。
Spring Boot配置SSL证书启用https访问性能与安全优化
启用HTTPS会带来一定的性能开销,因为每次请求都需要进行SSL握手和解密，通过合理的优化，可以将这种开销降至最低。
启用会话复用
SSL握手是一个计算密集型过程,通过启用会话复用（Session Resumption），客户端可以在后续请求中重用之前的会话参数，从而显著减少握手次数。
- 配置方式：在
application.yml中添加：server: ssl: session: timeout: 86400 # 会话超时时间，单位为秒 mode: both # 支持会话ID和会话票据两种复用方式
选择合适的加密套件
并非所有加密算法都是安全的或高效的,建议使用现代、安全的加密套件，如TLSv1.2或TLSv1.3。
- 禁用旧协议：确保禁用SSLv3、TLSv1.0和TLSv1.1等存在已知漏洞的协议。
- 优先使用ECDHE：椭圆曲线Diffie-Hellman密钥交换（ECDHE）提供了前向保密性，即使私钥泄露，过去的通信也不会被解密。
HTTP/2的支持
HTTP/2协议天然支持多路复用和头部压缩，能显著提升HTTPS性能，Spring Boot 2.x及以上版本默认支持HTTP/2。
- 启用条件：确保你的Servlet容器（如Tomcat）版本支持HTTP/2，并且证书配置正确。
- 验证方法：可以通过浏览器开发者工具的Network面板查看协议版本是否为h2。
Spring Boot配置SSL证书启用https访问Q&A
Spring Boot配置SSL证书启用https访问时，JKS和PKCS12有什么区别？
JKS是Java特有的密钥库格式,而PKCS12是行业标准格式，PKCS12兼容性更好，支持跨平台使用，且是Java 9+的默认格式，业内专家指出，新项目应优先选择PKCS12，以避免潜在兼容性问题。
如何在Spring Boot中同时支持HTTP和HTTPS？
可以通过配置两个Connector来实现,一个Connector监听HTTP端口，另一个监听HTTPS端口，在Tomcat中，可以通过自定义TomcatServletWebServerFactory来添加额外的Connector，HTTP Connector会将所有请求重定向到HTTPS Connector。
Spring Boot配置SSL证书启用https访问后，为什么访问速度变慢？
HTTPS增加了SSL握手和解密的开销,如果握手次数频繁，速度会明显下降，通过启用会话复用、升级TLS版本至1.3、以及使用支持硬件加速的服务器，可以显著改善性能，据统计，合理优化后，HTTPS的性能损耗可控制在5%以内。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/409392.html
