以前用的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);
最终取得成功，感动死我了！！！！！！
参数还没修改见谅，就此结束，大家可以参考下，别踩雷了！！！
