zoukankan      html  css  js  c++  java
  • swagger2报错Unable to render this definition

    前言

    这个问题是第二次遇到了,索性就记录下来;

    问题描述

    Unable to render this definition
    The provided definition does not specify a valid version field.
    Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.0.n (for example, openapi: 3.0.0).

    解决办法

    查看接口返回api-docs信息

    控制台报错:system.js:461 TypeError: Cannot convert undefined or null to object

    接口api-docs返回信息未正确解析导致;

    添加mvc配置

    @Configuration
    @EnableWebMvc
    public class MvcConfiguration implements WebMvcConfigurer {
    
        @Bean
        public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
            MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
            converter.setObjectMapper(objectMapper());
            return converter;
        }
    
        @Bean
        ObjectMapper objectMapper(){
            ObjectMapper om = new ObjectMapper();
            om.setSerializationInclusion(JsonInclude.Include.ALWAYS);
            // 设置 SerializationFeature.FAIL_ON_EMPTY_BEANS 为 false
            om.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
            om.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
            return om;
        }
    
        /**
         * 防止@EnableMvc把默认的静态资源路径覆盖了,手动设置的方式
         *
         * @param registry
         */
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            // 解决静态资源无法访问
            registry.addResourceHandler("/**").addResourceLocations("classpath:/static/");
            // 解决swagger无法访问
            registry.addResourceHandler("/swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
            // 解决swagger的js文件无法访问
            registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
        }
    }
    
  • 相关阅读:
    Python2 新手 编码问题 吐血总结
    朴素贝叶斯算法下的情感分析——C#编程实现
    element ui输入框监听enter回车事件
    MySql的动态语句foreach各种用法比较
    Mybatis中的CDATA标签的用法
    IDEA里面报黄色/灰色的重复代码的下划波浪线的去除方案
    wamp 3.0.6(apache 2.4.23) 403 forbidden 解决办法
    less文件编译成微信小程序wxss文件
    C#返回时间格式转换成 js 字符串
    Highcharts动态添加点数据
  • 原文地址:https://www.cnblogs.com/tinging/p/13262378.html
Copyright © 2011-2022 走看看