SpringBoot整合Swagger问题整理

最新推荐文章于 2024-12-09 10:23:11 发布

瞭望塔

最新推荐文章于 2024-12-09 10:23:11 发布

阅读量3.5k

点赞数 2

文章标签： Swagger SpringBoot fastjson swagger

本文链接：https://blog.csdn.net/congge_1993/article/details/82629266

版权

本文总结了SpringBoot整合Swagger时可能遇到的问题，包括Swagger版本与SpringBoot版本的匹配，访问Swagger页面显示空白的解决，日期时间格式的设置，以及静态资源映射问题和Docket配置冲突。解决方案涉及移除fastjson相关代码，使用FastJsonConfig定制日期格式，配置静态资源映射，以及处理Docket的groupName和时区问题。

摘要由CSDN通过智能技术生成

1、swagger版本与springboot版本

本项目使用的是Swagger版本是2.7.0，该版本对应的spring版本是4.3.10，所使用的SpringBoot版本在1.5.6.RELEASE版本左右都是可以的。一般版本差距太大才会导致冲突。

2、按步骤导入jar包，添加配置类后，启动时未报错，但访问http://localhost:8080/swagger-ui.html时页面显示空白，如下：

查看控制台并无报错，查看log日志也无明显错误信息，访问http://localhost:8080/v2/api-docs发现有返回值但是只有一个key为value的json串返回，因此有可能是对返回值处理时出现了问题。查询资料得知有可能有fastjson有关，而项目中之前为了处理返回日期类型为时间戳，自定义了HttpMessageConverter，里面有用到fastjson包中JSON对象，注解掉相关代码：

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    super.configureMessageConverters(converters);

最低0.47元/天解锁文章