以前用的swagger2,忽然发现springdoc还在更新,就开始尝试新玩法,项目中加入了springsecutiry,第一次使用过程中还是遇到许多的bug,最终还有一个非常不理解的问题,经导师寻找最终找到问题所在,终解决,感动两年半,下面细谈:
首先遇到第一个bug,死活进不去主页http://localhost:8080/swagger-ui/index.html#/
这是swagger的文档,找着找着才忽然发现自己把自己拦截了,赶紧把自己放过去
.antMatchers(
HttpMethod.GET, // Swagger的资源路径需要允许访问
“/”,
“/swagger-ui.html”,
“/swagger-ui/”,
“/*.html”,
“/favicon.ico”,
“/swagger-resources/",
"/v3/api-docs/”
// “/swagger-ui/index.html”,
// “/swagger-ui.html”,
// “/swagger-ui/",
// "/v3/api-docs/”,
// “/v3/api-docs”
).permitAll()
终于进去了!!!当我以为我已经成功了,没想到:
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).
这个问题把我尬住了,以前也算是遇过,把各种问题排除,以及不断的尝试,死活过不去,真是一个bug找了两年半,看不太懂底层,没办法一个个排,只能硬找,通过三天三夜的努力,我成功放弃了,我找不到!!!!!
都有接收到,但是json序列化炸了,真是理解不能。
好不容易熬到周一,赶紧找我导师问一问,经过他一顿操作,帮我锁定了问题,说把一段代码注释掉就行,我当场蒙蔽了,一尝试就可以了!!--------无语
原来根本不是我配置的问题,因为在处理日期json序列化的时候,我们一般有三种方法:
- @JSONField(format = “…”)来指定格式
- .setDateFormat(“…”)指定全局Date字段的序列化格式
- setSerializerFeatures(SerializerFeature.WriteDateUseDateFormat)
指定全局Date字段的默认序列化格式。
这三种方式存在着优先级:方式二 > 方式一 > 方式三,当前一级出现的时候,会直接覆盖掉下一层的配置,具体细看::pringBoot使用fastjosn作为消息转换器、fastjosn对日期的处理、自定义序列化器解决SerializerFeature兼容问题
对此真的没想到,然后通过一段操作,发现是序列化的问题!!!—哭了
原本是不想通过JSONFieLId来对一个个字段进行指定的操作,嫌弃麻烦,就通过消息HttpMessageConverter操作,注入到@bean中,虽然经过一波查询,感觉到参数模型传递错误的bug,但是实在排查不出来,这个在序列化的时候fastjson对此作了特殊处理,因此可以保持原样。而改换springdoc时,此处传入的class却是String! 而fastjson默认会对String进行处理,加上转义符号,因此导致最终的结果出现异常。),真没想到是这种大无语事件,对此我们有两种方式解决:
//
- 换成Jackson的converter(springboot默认就是Jackson)。
- FastJsonHttpMessageConverter:自定义一个StringSerializer,覆盖掉fastjson的默认的StringSerializer
由于实在太懒了,决定自定义一个序列化的,覆盖掉原来的操作。
public class MyStringSerializer implements ObjectSerializer {
public static final MyStringSerializer instance = new MyStringSerializer();
@Override
public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException {
SerializeWriter out = serializer.getWriter();
out.write(object.toString());
}
}
然后在FastJsonHttpMessageConverter的配置文件中,如下使用
fastJsonConfig.getSerializeConfig().put(String.class,MyStringSerializer.instance);
最终取得成功,感动死我了!!!!!!
参数还没修改见谅,就此结束,大家可以参考下,别踩雷了!!!