Swagger

目录

• 常见问题
  • Q1.swagger java.lang.NumberFormatException: empty String
  • Q2. 屏蔽 swagger 中的 v2/api-docs 和 v3/api-docs 防止恶意攻击

常见问题

Q1.swagger java.lang.NumberFormatException: empty String

因为springfox-swagger2(2.9.2)依赖于swagger-models(1.5.20)，而该版本的swagger会将实体类中非String 类型的属性默认赋值为空字符串，因此需要手动添加更高版本的swagger-models依赖。

<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.21</version>
</dependency>

Q2. 屏蔽 swagger 中的 v2/api-docs 和 v3/api-docs 防止恶意攻击

生产环境中需要屏蔽 v2/api-docs 和 v3/api-docs ，防止恶意攻击和泄露漏洞。

springfox:
  documentation:
    swagger-ui:
      enabled: false
    auto-startup: false