Swagger3.x和项目整合的注意事项

简介：项目中使用Swagger整合接口文档常见问题

• 明确接口的Http请求方式

  • 一个接口使用@RequestMapping会生成多个文档

• 线上不要开启接口文档

   

• 考虑团队当下和未来是否可以一直用，没有说百分百好用，缺点和优点都要知道

• 大厂里面基本也是这样的情况

  • 举个阿里和企鹅的例子

    • 里面的接口文档工具都有好几个
    • 总能调出旧版的问题，然后就重复造轮子，可能就比原先的轮子好点，拿个好的绩效就不咋维护了
    • 来年其他人继续这样去做