java bug 后端 Knife4j文档请求异常(基于SpringBoot3，查找原因并解决)

博主采用的是SpringBoot3+knife4j的框架，如果你采用的是SpringBoot2框架，那么可以看下面这几篇：

Knife4j文档请求异常 | Knife4j

记一次集成swagger2（Knife4j）在线文档异常，提示：Knude4j文档请求异常_knife4j文档请求异常-CSDN博客全网多种方式解决Knife4j文档请求异常-CSDN博客

博主最近做苍穹外卖时碰到了一个问题，Knife4j文档请求异常，如下图所示：

于是F12打开控制台准备进行debug，发现报出如下错误：

 大致意思是JSON返回了一个token，继续从网络的响应查找：

发现响应码(200)正常，并且返回格式为json，查看响应内容：

居然是一长串字符串，而不是Json数据。于是到了最令人烦躁的debug环节，从编辑器控制台查看没有任何ERROR甚至WARN信息：

2024-01-09T15:17:43.508+08:00 INFO 22868 --- [ main] com.sky.SkyApplication : Starting SkyApplication using Java 17.0.8 with PID 22868 (E:\Code\sky_take_out_proj\sky_take_out\sky_server\target\classes started by User in E:\Code\sky_take_out_proj\sky_take_out)

2024-01-09T15:17:43.510+08:00 INFO 22868 --- [ main] com.sky.SkyApplication : The following 1 profile is active: "dev"

2024-01-09T15:17:44.228+08:00 INFO 22868 --- [ main] .s.d.r.c.RepositoryConfigurationDelegate : Multiple Spring Data modules found, entering strict repository configuration mode

2024-01-09T15:17:44.230+08:00 INFO 22868 --- [ main] .s.d.r.c.RepositoryConfigurationDelegate : Bootstrapping Spring Data Redis repositories in DEFAULT mode.

2024-01-09T15:17:44.265+08:00 INFO 22868 --- [ main] .s.d.r.c.RepositoryConfigurationDelegate : Finished Spring Data repository scanning in 23 ms. Found 0 Redis repository interfaces.

2024-01-09T15:17:44.830+08:00 INFO 22868 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)

2024-01-09T15:17:44.837+08:00 INFO 22868 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]

2024-01-09T15:17:44.837+08:00 INFO 22868 --- [ main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.16]

2024-01-09T15:17:44.920+08:00 INFO 22868 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext

2024-01-09T15:17:44.920+08:00 INFO 22868 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1369 ms

Standard Commons Logging discovery in action with spring-jcl: please remove commons-logging.jar from classpath in order to avoid potential conflicts

2024-01-09T15:17:45.242+08:00 INFO 22868 --- [ main] com.sky.config.WebMvcConfiguration : 开始注册自定义拦截器...

2024-01-09T15:17:45.908+08:00 INFO 22868 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''

2024-01-09T15:17:45.917+08:00 INFO 22868 --- [ main] com.sky.SkyApplication : Started SkyApplication in 3.027 seconds (process running for 3.722)

2024-01-09T15:17:45.919+08:00 INFO 22868 --- [ main] com.sky.SkyApplication : server started

2024-01-09T15:19:13.412+08:00 INFO 22868 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring DispatcherServlet 'dispatcherServlet'

2024-01-09T15:19:13.413+08:00 INFO 22868 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Initializing Servlet 'dispatcherServlet'

2024-01-09T15:19:13.414+08:00 INFO 22868 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Completed initialization in 1 ms

2024-01-09T15:19:14.040+08:00 INFO 22868 --- [nio-8080-exec-6] o.springdoc.api.AbstractOpenApiResource : Init duration for springdoc-openapi is: 261 ms

突然想起来之前设置过一个消息转换器，将Date类型转换为yyyy-MM-dd HH:mm格式去显示，于是考虑是否因为消息转换器，将JSON数据不正常解析了？

/**

* 扩展消息转换器,将日期类型从列表转换为时间戳

* @param converters 消息转换器列表

*/

@Override

protected void extendMessageConverters(List> converters) {

MappingJackson2HttpMessageConverter jackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();

jackson2HttpMessageConverter.setObjectMapper(new JacksonObjectMapper());

converters.add(0,jackson2HttpMessageConverter);

}

于是将消息转换器注释掉，便正常显示了：

返回的JSON数据也正常了，代价是后端返回的时间数据不是上面提到的格式，而是列表,导致前端显示错误的格式：

至此

如果你还想保留消息转换器，让后端返回正确的时间数据格式，那么可以调整消息转换器列表中转换器的顺序，代码如下。

/**

* 扩展消息转换器,将日期类型从列表转换为时间戳

* 这个是导致knife4j不能正常显示的罪魁祸首,特别要注意添加的位置

* @param converters 消息转换器列表

*/

@Override

protected void extendMessageConverters(List> converters) {

MappingJackson2HttpMessageConverter jackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();

jackson2HttpMessageConverter.setObjectMapper(new JacksonObjectMapper());

converters.add(converters.size()-1,jackson2HttpMessageConverter);

}

一些参考文章：

MappingJackson2HttpMessageConverter使用及jackson配置原理和避坑说明-CSDN博客

一步到位 SpringBoot 序列化与消息转换器 (你需要的这里都有)_springboot 序列化 自定义转换器-CSDN博客

 为什么说HttpMessageConverter的顺序非常重要_SpringBoot 

相关链接

 您阅读本篇文章共花了：