流年不利流年不利啊。项目写的太傻,庞大到生成了几百兆的Swagger文档。 通常,有个几兆就到了忍受极限了,这直接爆出几百兆。
问题源于这么一篇文章:小技巧:SpringBoot项目如何让前端开发提高效率?。其中提到使用swagger可以让前端、后端、QA、产品互动起来,很多研发已经用了。但有些项目生成的文章忒TM大了(抱歉我控制不住),在让这些项目愉快的go die之前,还是得想办法处理呀。
第一就是过滤减肥。 看一下你的Controller里写的是不是
@RequestMapping
这个注解将会生成7
条api信息
GET、HEAD、POST、PUT、DELETE、OPTIONS、PATCH
如果你能够确定调用方法,比如GET,请将注解改成
@GetMapping
返回的实体,还有请求的参数,不要循环引用。请干掉这些代码,不要邋遢,设计一点干净的api。
另一种思路就是把这些api都给捣鼓到线下,倒入到一个统一的地方进行管理。 这些也已经有很多产品了,比如Rap、Nei、YApi。
拿YApi来说(支持源码搭建),可以输入相应swagger的地址,进行一次导入,就可以将api定义转到另一个平台了。
YApi还有权限管理功能,应该是这里面做的最Nice的了。如果你想要统一管理、内网隔离,推荐一试。好东西,就不多介绍了。
转到线下虽然解决了因为api过大造成的服务不稳定,但api的更新同步会是另外一个问题。
不管采用何种方式,合理简洁的api设计是首要的。调用方法固定,不循环引用,最重要的,记得分模块哦。