实用干货！看壹哥如何在SpringBoot项目中同时支持https和http协议

快来打我* 2024-04-08 08:55 74阅读 0赞

最近**壹哥**的一个学生在做项目时碰到了一个特殊的需求，前端浏览器需要存放跨域请求的cookie，需要将cookie的secure属性设置为true。这样一来，就要求后端的接口必须以HTTPS协议提供访问，那么我们该如何在Springboot项目中使用Https协议呢？是否一定要花钱购买数字证书才可以呢？

其实如果我们只是在开发和测试阶段，完全可以使用自定义的数字证书，并通过简单的配置，即可让Springboot程序切换成Https协议。

接下来**壹哥**就带各位在SpringBoot项目中实现该功能。

## **一.** **创建自定义数字证书** ##

首先我们得创建一个自定义的数字证书。其实在JDK中，就提供了现成的工具用于生成数字证书，我们只需打开命令行工具，执行如下代码即可生成一个数字证书。

keytool -genkeypair -alias springboot-https 
    -keypass 123456 -keyalg RSA 
    -keysize 2048 -validity 365 
    -keystore d:/cert/springboot.keystore -storepass 123456

执行结果如下图所示：

![bc9c53ecc3b8401da8c761de1e2464d2.png][]

这里会出现一个警告，我们按照提示更改一下证书密钥库的格式即可。

keytool -importkeystore -srckeystore d:/cert/springboot.keystore 
    -destkeystore d:/cert/springboot.keystore -deststoretype pkcs12

![5288dba85cff45a9a0d10dd858aa3ed9.png][]

这样我们就将密钥库格式转换为pkcs12格式了，此时得到的密钥库文件如下图所示，其中springboot.keystore就是我们所需要的密钥库文件。

![1a5d7fc369d440e1a7ac6065ff1fa0e0.png][]

## **二.** **配置Springboot** ##

### 1. 导入数字证书 ###

接着我们要将生成的密钥库文件，放入到Springboot工程中的resources目录下，如下图所示：

![0e0f7b6d2d65417a8607d8b7bd98cfc5.png][]

### 2. 创建yml配置文件 ###

然后添加如下格式的yml配置信息。

server:
      ssl:
        #开启https
        enabled: true
        #指定存放证书的密钥库文件的位置
        key-store: classpath:springboot.keystore
        #密钥库文件的格式
        key-store-type: PKCS12
        #别名，需要与创建密钥库时的别名一致
        key-alias: springboot-https
        key-password: 123456
        key-store-password: 123456

### 3. 创建Java测试类 ###

这里我们可以写一个Java测试类。

@SpringBootApplication
    @RestController
    public class DemoApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(DemoApplication.class, args);
        }
    
        @RequestMapping("/")
        public String hello() {
            return "hello";
        }
    }

#### 4. 测试访问 ####

接下来我们启动程序，并通过默认的8080端口进行访问。

![9fec36e4191749c794ac92696aa6f8c8.png][]

此时我们会发现，当使用http协议访问时，会看到上图所示的错误提示信息，接着我们换成https协议访问。

![c2195ac5be084c1bb54fa9779084e83e.png][]

这里由于数字证书是我们自己生成的，没有CA给我们认证，因此浏览器给出了安全提示，我们只需点击高级按钮，继续前往即可。

![de87af3b775c448b912fe718e500fb04.png][]

我们发现，最终接口就访问成功了。

![771f2fbd2fe14b8dba43a8ca90ed099d.png][]

## **三. 同时支持http协议和https协议** ##

但在有的项目中，会要求我们同时支持http和https协议，这该怎么实现呢？我们继续往下看。

### 1. 配置http端口 ###

首先我们在yml配置文件中，添加http端口号定义。

http:
      port: 8888

### 2. 创建配置类 ###

接着我们在Java配置类中，向IOC容器中添加如下Bean。

@Value("${http.port}")
    private Integer httpPort;
    
    @Bean
    public ServletWebServerFactory servletContainer(){
        final Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
            connector.setPort(httpPort);
        final TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory();
        
        tomcat.addAdditionalTomcatConnectors(connector);
        return tomcat;
    }

### 3. 启动测试 ###

启动项目时，我们会发现如下日志，Tomcat绑定了两个端口号，其中https绑定在8080，http绑定在8888。

![98bb8237f6954a9eb54715385b58108d.png][]

以Http协议访问会如下图所示，我们发现可以正常访问到接口。

![eba30d473cbe4e2abc5eb1d86962b0ec.png][]再以Https协议访问会如下图所示，也可以正常访问到接口。

![b272e874a9b944e7a97db7696c2e7bc9.png][]

这样我们就实现了一个项目中同时支持http和https协议，现在你是不是学会了呢？如果你还有什么别的疑问，可以在评论区留言哦。关注**壹哥**，每天干货都不断！

[bc9c53ecc3b8401da8c761de1e2464d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/84f9438be04c4e7ba5ca47a1cdf0570f.png
[5288dba85cff45a9a0d10dd858aa3ed9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/6c0958dc71884d0a8660cf3831604bbc.png
[1a5d7fc369d440e1a7ac6065ff1fa0e0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/f67d3d5265bd485ba49607d304c1b2e9.png
[0e0f7b6d2d65417a8607d8b7bd98cfc5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/99d17870103f4f4fa96870fc686050c4.png
[9fec36e4191749c794ac92696aa6f8c8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/a459c4f1dfe74061a4512069fab4b16f.png
[c2195ac5be084c1bb54fa9779084e83e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/d37a28eaee5245b3a23b1b4f53e38c12.png
[de87af3b775c448b912fe718e500fb04.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/1f4ab5df2e8e447e9483ab002d15e4c8.png
[771f2fbd2fe14b8dba43a8ca90ed099d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/2f2fc037d54745dca4298e412d48c202.png
[98bb8237f6954a9eb54715385b58108d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/d4b2045da75e499db87c56e59ef02e56.png
[eba30d473cbe4e2abc5eb1d86962b0ec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/706bef2538c2487b98b8efcbdff623cc.png
[b272e874a9b944e7a97db7696c2e7bc9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/f4f922eba971407fb0f90c77e2f722c6.png