Swagger注解的坑

79 阅读3分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 10 月更文挑战」的第6天,点击查看活动详情

前言

兄弟们,今天做了一件大事儿,清理了一些该清理的记录,四年,翻篇了。以后就做自己的星星了,要闪闪发光呀! 今天浅浅地回忆了一下以前遇到的一个问题,记录一下吧~(没有划水,真实遇到的坑)

Swagger注解引发的错误

@Configuration @EnableSwagger2

错误页面: 错误页面 提示:

 1. 2021-07-30 13:13:06.164  INFO 12536 --- [           main] c.example.demo0726.Demo0726Application   : Starting Demo0726Application using Java 1.8.0_101 on DESKTOP-41DCVHB with PID 12536 (D:\demo0726\target\classes started by lenovo in D:\demo0726)
 2. 2021-07-30 13:13:06.167  INFO 12536 --- [           main] c.example.demo0726.Demo0726Application   : No active profile set, falling back to default profiles: default
 3. 2021-07-30 13:13:08.064  INFO 12536 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 9999 (http)
 4. 2021-07-30 13:13:08.080  INFO 12536 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
 5. 2021-07-30 13:13:08.080  INFO 12536 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.50]
 6. 2021-07-30 13:13:08.195  INFO 12536 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
 7. 2021-07-30 13:13:08.195  INFO 12536 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1918 ms
 8. 2021-07-30 13:13:09.056  INFO 12536 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 9999 (http) with context path ''
 9. 2021-07-30 13:13:09.065  INFO 12536 --- [           main] c.example.demo0726.Demo0726Application   : Started Demo0726Application in 3.696 seconds (JVM running for 4.579)

编译结果: 编译结果 加上注解后编译的提示:

2021-07-30 13:17:31.839  INFO 32788 --- [           main] c.example.demo0726.Demo0726Application   : Starting Demo0726Application using Java 1.8.0_101 on DESKTOP-41DCVHB with PID 32788 (D:\demo0726\target\classes started by lenovo in D:\demo0726)
2021-07-30 13:17:31.842  INFO 32788 --- [           main] c.example.demo0726.Demo0726Application   : No active profile set, falling back to default profiles: default
2021-07-30 13:17:33.264  INFO 32788 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 9999 (http)
2021-07-30 13:17:33.284  INFO 32788 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2021-07-30 13:17:33.284  INFO 32788 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.50]
2021-07-30 13:17:33.398  INFO 32788 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2021-07-30 13:17:33.398  INFO 32788 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1509 ms
2021-07-30 13:17:34.074  INFO 32788 --- [           main] pertySourcedRequestMappingHandlerMapping : Mapped URL path [/v2/api-docs] onto method [springfox.documentation.swagger2.web.Swagger2Controller#getDocumentation(String, HttpServletRequest)]
2021-07-30 13:17:34.385  INFO 32788 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 9999 (http) with context path ''
2021-07-30 13:17:34.386  INFO 32788 --- [           main] d.s.w.p.DocumentationPluginsBootstrapper : Context refreshed
2021-07-30 13:17:34.414  INFO 32788 --- [           main] d.s.w.p.DocumentationPluginsBootstrapper : Found 1 custom documentation plugin(s)
2021-07-30 13:17:34.459  INFO 32788 --- [           main] s.d.s.w.s.ApiListingReferenceScanner     : Scanning for api listing references
2021-07-30 13:17:34.645  INFO 32788 --- [           main] c.example.demo0726.Demo0726Application   : Started Demo0726Application in 3.289 seconds (JVM running for 3.977)

加上注解后编译结果: 正确编译 正确显示: 在这里插入图片描述

综述

在整合spring boot和swagger的时候一般会对swagger进行配置,即加上 @Configuration @EnableSwagger2 这两个注解;如果有兄弟们遇到同样的问题可以try一下嘛!