Swagger UI为何不显示名为IDCard的接口？

可能的原因 #

• Swagger内置过滤规则或关键字冲突：部分Swagger实现（如Springfox、Springdoc）可能存在默认的接口名称过滤逻辑，"IDCard"中的"Card"字符串可能触发了隐性的排除规则，导致接口被跳过文档生成，但后端接口本身正常注册，所以Postman可正常调用。
• 名称解析的大小写或格式bug：部分Swagger版本对驼峰命名的特定组合（如"IDCard"这种大写开头加驼峰的格式）存在解析异常，无法正确生成对应的API文档节点，但不影响接口的功能可用性。
• Swagger注解的隐性冲突：如果接口使用了@Api、@ApiOperation等Swagger注解，"IDCard"可能和注解内部的某些关键字、占位符逻辑冲突，导致文档生成失败，但接口业务逻辑不受影响。

日志排查方式 #

Swagger没有单独的日志文件，相关日志会输出到应用的主日志中。可以通过调整应用日志级别来获取详细的文档生成日志：

• 以Spring Boot为例，在application.yml中添加配置：

  logging:
    level:
      io.swagger: DEBUG
      springfox: DEBUG # 若用Springfox则加这行，Springdoc则替换为org.springdoc
  

  重启应用后，查看日志中关于API扫描、文档构建的部分，能找到"IDCard"接口被排除的具体原因，比如过滤规则触发提示、解析错误的堆栈信息。

内容的提问来源于stack exchange，提问作者Powerslave