iis服务器助手广告广告
返回顶部
首页 > 资讯 > 后端开发 > Python >swagger配置正式环境中不可访问的问题
  • 117
分享到

swagger配置正式环境中不可访问的问题

2024-04-02 19:04:59 117人浏览 八月长安

Python 官方文档:入门教程 => 点击学习

摘要

目录swagger配置正式环境中不可访问如何在生产环境中禁止swagger了?以下是正式环境访问swagger无法打开的说明总结了以下几个解决方案swagger配置正式环境中不可访问

swagger配置正式环境中不可访问

Swagger是我们常用的api Doc工具,非常便于开发人员调试,后台和前端开发人员协作,以及对外公布API使用。

如何在生产环境中禁止swagger了?

@Profile("beta")  // 只允许在测试服务器访问Swagger

package com.demo.swagger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.WEB.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
@Profile("beta")
public class SwaggerConfig {
    @Bean
    public Docket buildDocket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(buildApiInf())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo buildApiInf() {
        return new ApiInfoBuilder()
                .title("管理系统接口文档")
                .description("后台管理 API 接口文档")
                .version(DocumentationType.SWAGGER_2.getVersion())
                .build();
    }
}

以下是正式环境访问

swagger无法打开的说明

最近项目集成swagger2,结果本地swagger-ui.html可以打开,但是线上环境却无法打开。倒腾了一番终于解决问题

总结了以下几个解决方案

1.@EnableWebmvc注解必须去掉!

2.请实现WebMvcConfigurer,并添加如下代码

@Override
public void addResourceHandlers(ResourceHandlerReGIStry registry) {
  registry.addResourceHandler("swagger-ui.html")
      .addResourceLocations("classpath:/META-INF/resources/swagger-ui.html");
  registry.addResourceHandler("/webjars/**")
      .addResourceLocations("classpath:/META-INF/resources/webjars/");
}

3.检查配置文件application.properties

将如下配置去掉,或者改成true:

spring.resources.add-mappings=false

将如下配置去掉:

spring.resources.static-locations: classpath:/webapp/

4.查看Nginx配置(当前项目踩坑点)

检查前端代码,发现nginx配置有如下一段:

location /api/swagger-ui.html{
        proxy_pass Http://server-service:8080/;
        proxy_set_header X-Real-IP $remote_addr;
        client_max_body_size    1000m;
}

由于当前应用部署在k8s环境中,后端的api地址恰好为http://server-service:8080/,所以这个配置会导致请求直接转发到后端接口,导致无法访问页面。

事实上,针对swagger,前端nginx不需要做任何映射,直接请求 http:// {后端公网host}/swagger-ui.html 即可访问。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持编程网。 

--结束END--

本文标题: swagger配置正式环境中不可访问的问题

本文链接: https://www.lsjlt.com/news/151356.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作