SpringMvc访问页面404

SpringMvc中文档出现异常一般分2种情况:

  • doc.html打开提示404
  • doc.html已经可以打开,但是页面无任何接口文档
    针对以上两种情况的解决办法:

第一种:doc.html打开提示404?

一般无需添加此配置,如果出现这种情况,在Spring的xml配置文件中,添加Spring的静态资源映射路径即可,如下:

  1. <mvc:resources location="classpath:/META-INF/resources/" mapping="doc.html"/>
  2. <mvc:resources location="classpath:/META-INF/resources/webjars/" mapping="/webjars/**"/>

第二种:doc.html已经可以打开,但是页面无任何接口文档?

web.xml中配置了DispatcherServlet,则需要追加一个url匹配规则,如下

  1. <!-- 配置swagger-bootstrap-ui的url请求路径-->
  2. <servlet-mapping>
  3. <servlet-name>swaggerDemoMvc</servlet-name>
  4. <url-pattern>/v2/api-docs</url-pattern>
  5. </servlet-mapping>
  6. <servlet-mapping>
  7. <servlet-name>swaggerDemoMvc</servlet-name>
  8. <url-pattern>/swagger-resources</url-pattern>
  9. </servlet-mapping>
  10. <servlet-mapping>
  11. <servlet-name>swaggerDemoMvc</servlet-name>
  12. <url-pattern>/swagger-resources/configuration/ui</url-pattern>
  13. </servlet-mapping>
  14. <servlet-mapping>
  15. <servlet-name>swaggerDemoMvc</servlet-name>
  16. <url-pattern>/swagger-resources/configuration/security</url-pattern>
  17. </servlet-mapping>
  18. <!--此接口地址为SwaggerBootstrapUi提供的增强地址,如果不使用增强功能,可排除此配置-->
  19. <servlet-mapping>
  20. <servlet-name>swaggerDemoMvc</servlet-name>
  21. <url-pattern>/v2/api-docs-ext</url-pattern>
  22. </servlet-mapping>

关于SpringMvc的代码示例可参考swagger-bootstrap-ui-demo-mvc