快捷導(dǎo)航

將SpringBoot項(xiàng)目的HTTP站點(diǎn)改為HTTPS的全過(guò)程

更新時(shí)間：2026年02月12日 08:58:59 作者：麥芽糖0219

本文介紹了如何在Spring Boot項(xiàng)目中實(shí)現(xiàn)HTTPS請(qǐng)求,首先,創(chuàng)建一個(gè)Spring Boot項(xiàng)目并編寫(xiě)一個(gè)BasicController.java文件,然后,配置application.yaml文件以支持HTTPS,接著,使用Java自帶的keytool工具生成一個(gè)免費(fèi)的HTTPS證書(shū),需要的朋友可以參考下

一新建springboot項(xiàng)目

我們先新建一個(gè)springboot項(xiàng)目，寫(xiě)一個(gè)BasicController.java，內(nèi)容如下

package com.https.httpsdemo.demos.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
public class BasicController {

    // http://127.0.0.1:8081/hello
    @GetMapping("/hello")
    @ResponseBody
    public String hello() {
        return "Hello ";
    }
}

application.yaml內(nèi)容如下

server:
  port: 8081

瀏覽器訪問(wèn)http://127.0.0.1:8081/hello如下

接下來(lái)開(kāi)始把http請(qǐng)求改為https

二 https證書(shū)

首先需要有一個(gè) https 證書(shū)，可以從各個(gè)云服務(wù)廠商處申請(qǐng)一個(gè)免費(fèi)的（我申請(qǐng)的為阿里云SSL)，也可以直接借助 Java 自帶的 JDK 管理工具 keytool 來(lái)生成一個(gè)免費(fèi)的 https 證書(shū)。

找到命令窗口，右鍵選擇管理員打開(kāi)

執(zhí)行如下命令

keytool -genkey -alias tomcat -storetype PKCS12 -keyalg RSA -keysize 2048 -keystore keystore.p12 -validity 3650

命令含義如下：

genkey 表示要?jiǎng)?chuàng)建一個(gè)新的密鑰。
alias 表示 keystore 的別名。
keyalg 表示使用的加密算法是 RSA ，一種非對(duì)稱(chēng)加密算法。
keysize 表示密鑰的長(zhǎng)度。
keystore 表示生成的密鑰存放位置。
validity 表示密鑰的有效時(shí)間，單位為天。

如上圖，以此輸入相關(guān)信息即可。

在C:\Windows\System32目錄可以看到生成了文件

把上邊這個(gè)文件復(fù)制到項(xiàng)目根目錄下

application.yml文件如下

# 應(yīng)用服務(wù) WEB 訪問(wèn)端口
server:
  port: 8081
  ssl:
    # 證書(shū)路徑，秘鑰文件路徑，也可以配置絕對(duì)路徑
    key-store: keystore.p12
    # 證書(shū)密碼，秘鑰生成時(shí)在終端輸入的秘鑰口令
    key-store-password: 123456
    # 秘鑰類(lèi)型，與秘鑰生成命令一樣
    key-store-type: PKCS12
    # 證書(shū)別名，與秘鑰生成命令一樣
    key-alias: tomcat

啟動(dòng)類(lèi)添加如下內(nèi)容

package com.https.httpsdemo;

import org.apache.catalina.Context;
import org.apache.catalina.connector.Connector;
import org.apache.tomcat.util.descriptor.web.SecurityCollection;
import org.apache.tomcat.util.descriptor.web.SecurityConstraint;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.servlet.server.ServletWebServerFactory;
import org.springframework.context.annotation.Bean;


@SpringBootApplication
public class HttpsDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(HttpsDemoApplication.class, args);
    }
    @Bean
    public ServletWebServerFactory servletContainer() {
        TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(Context context) {
                SecurityConstraint securityConstraint = new SecurityConstraint();
                securityConstraint.setUserConstraint("CONFIDENTIAL");
                SecurityCollection collection = new SecurityCollection();
                collection.addPattern("/*");
                securityConstraint.addCollection(collection);
                context.addConstraint(securityConstraint);
            }
        };
        tomcat.addAdditionalTomcatConnectors(redirectConnector());
        return tomcat;
    }

    /**
     * 瀏覽器訪問(wèn)http://127.0.0.1:8080/hello時(shí)，自動(dòng)跳轉(zhuǎn)到https://127.0.0.1:8081/hello
     * @return
     */
    private Connector redirectConnector() {
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        connector.setPort(8080);
        connector.setSecure(false);
        connector.setRedirectPort(8081);
        return connector;
    }
}

此時(shí)，我們?cè)跒g覽器就可以通過(guò)https來(lái)訪問(wèn)https://127.0.0.1:8081/hello了

因?yàn)槲矣玫氖亲约荷傻膕sl證書(shū)，所以https請(qǐng)求是不被客戶端識(shí)別的，如下