在 Spring Boot 项目中安装 SSL 证书的完整指南
海外云服务器 40个地区可选 亚太云服务器 香港 日本 韩国
云虚拟主机 个人和企业网站的理想选择 俄罗斯电商外贸虚拟主机 赠送SSL证书
美国云虚拟主机 助力出海企业低成本上云 WAF网站防火墙 为您的业务网站保驾护航
在现代 Web 应用开发中，保障数据传输的安全性是构建高可信度系统的基石，为了实现 HTTPS 加密通信，服务器端必须安装 SSL/TLS 证书，对于使用 Spring Boot 框架构建的应用程序而言，配置 SSL 证书以启用 HTTPS 访问是一项常见但至关重要的任务。
准备 SSL 证书
你需要获取一个 SSL 证书，可以从权威的证书颁发机构（CA）购买正式证书，也可以使用工具（如 OpenSSL 或 Java 自带的 keytool）生成自签名证书用于本地测试。
以使用 keytool 生成自签名证书为例，执行以下命令：
keytool -genkeypair -alias ssl-demo -keyalg RSA -keysize 2048 -storetype PKCS12 -keystore ssl-demo.p12 -validity 3650
上述命令将生成一个名为 ssl-demo.p12 的 PKCS#12 格式证书文件，有效期为 10 年（即 3650 天），执行过程中需要设置密钥库密码（Keystore Password）和证书别名密码（Key Password），请妥善保存这些信息。
配置 Spring Boot 项目
在获得 SSL 证书后，接下来需要在 Spring Boot 项目中进行配置，启用 HTTPS 协议。
将生成的 ssl-demo.p12 文件放入项目的 src/main/resources 目录下，以便 Spring Boot 能够正确加载该证书。
使用 application.properties 配置
server.port=443 server.ssl.enabled=true server.ssl.key-store=classpath:ssl-demo.p12 server.ssl.key-store-password=your_keystore_password server.ssl.key-store-type=PKCS12 server.ssl.key-alias=ssl-demo
使用 application.yml 配置
server:
port: 443
ssl:
enabled: true
key-store: classpath:ssl-demo.p12
key-store-password: your_keystore_password
key-store-type: PKCS12
key-alias: ssl-demo
请将 your_keystore_password 替换为你在生成证书时设置的密钥库密码。
注意：如果你使用的是
.jks格式的证书，则需要将key-store-type改为JKS，Spring Boot 支持多种证书格式，确保配置参数与实际证书类型一致。
测试 HTTPS 访问
完成配置后,启动 Spring Boot 应用，你可以通过浏览器访问 https://localhost 或你的服务器域名来验证 HTTPS 是否配置成功。
如果浏览器地址栏显示绿色的安全锁图标,表示 SSL 证书已正确加载，HTTPS 通信已启用。
但如果你使用的是自签名证书,浏览器可能会提示“此网站证书不受信任”，这是因为自签名证书未经过权威 CA 签发，属于非正式证书，在生产环境中，应使用由可信证书机构（如 Let's Encrypt、DigiCert、Symantec 等）颁发的正式证书，以确保兼容性和用户信任。
常见问题与注意事项
-
端口冲突问题
HTTPS 默认使用 443 端口，确保该端口未被其他服务占用，并在服务器防火墙中开放该端口。 -
证书路径问题
确保证书文件放置在类路径下（如resources目录），以便 Spring Boot 能够正确加载。 -
证书格式与配置匹配
Spring Boot 支持多种证书格式，如.jks、.p12等，务必根据证书类型设置正确的key-store-type参数。 -
多证书配置（双向 SSL）
若需启用双向 SSL（即客户端也需要提供证书进行身份验证），还需要配置信任库（TrustStore）等相关参数。 -
生产环境建议
建议使用由权威 CA 机构签发的证书，以确保更高的安全性、兼容性及浏览器信任度，建议定期更新证书并启用 HTTP 到 HTTPS 的重定向，提升整体安全性。
通过本文的介绍,你已经掌握了如何在 Spring Boot 项目中安装 SSL 证书并启用 HTTPS 通信，这一配置不仅增强了应用的安全性，也为部署至生产环境奠定了基础。
在实际项目开发中,合理配置 SSL 证书和 HTTPS 协议是保障用户数据安全、提升系统可信度的重要手段，希望本文能帮助你更好地理解和实践 Spring Boot 中的安全通信配置。
如需进一步了解如何配置 HTTP 到 HTTPS 的重定向、如何使用 Let's Encrypt 免费证书、或如何实现双向 SSL 认证，请关注后续文章。
