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