springdoc-openapi用户界面实现将请求设置为HTTPS
更新时间:2026年01月01日 15:56:55 作者:咚咚阳丶
文章介绍了在使用Swagger进行API测试时遇到HTTPS请求问题的解决方案,包括将服务地址添加到配置文件和在SpringDoc配置类中设置服务列表,从而使得Swagger页面能够正确发起HTTPS请求
一、问题描述
当我们的服务接口需要通过HTTPS访问时,通过swagger可视化页面请求接口的时候,发起的是HTTP请求,导致请求无法到达后端,影响测试。
二、解决方法
1、将服务的地址添加到配置文件中
swagger:
server-list:
#本地环境
- 127.0.0.1:8007
#线上https环境
- https://www.xxx.com 2、在SpringDoc的配置类中注入配置信息,并设置服务列表
import java.util.ArrayList;
import java.util.List;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.servers.Server;
import lombok.Data;
/**
* spring doc配置
*
* @author ldy
*/
@Data
@Configuration
@ConfigurationProperties(prefix = "swagger")
public class SpringDocConfig {
/**
* 服务地址列表
*/
private List<String> serverList;
@Bean
public OpenAPI restfulOpenAPI() {
OpenAPI openAPI = new OpenAPI()
.info(new Info().title("你的项目名称").description("Spring Boot3 Restful API").version("V1.0.0")
.license(new License().name("访问SpringDoc官方网站").url("http://springdoc.org")))
.externalDocs(
new ExternalDocumentation().description("欢迎访问LDY的技术博客").url("https://blog.csdn.net/ldy1016"));
// 手动配置服务地址列表
if (serverList != null && serverList.size() > 0) {
List<Server> servers = new ArrayList<>();
for (String server : serverList) {
servers.add(new Server().url(server));
}
openAPI.servers(servers);
}
return openAPI;
}
}三、运行效果
如图所示,在swagger页面的 Servers 列表中选择指定的接口根路径即可,接口根路径会根据你的选择自动变更。

总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。
相关文章
Apache SkyWalking 修复TTL timer 失效bug详解
这篇文章主要为大家介绍了Apache SkyWalking 修复TTL timer 失效bug详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2022-09-09
Java中的NumberFormatException异常原因以及解决方案详解
这篇文章主要介绍了Java中的NumberFormatException异常原因以及解决方案详解,NumberFormatException 是 Java 中的一个异常类,通常在字符串转换为数字的过程中发生,它表示一个无效的数字格式,即字符串无法被正确解析为数字,需要的朋友可以参考下2024-02-02


最新评论