SpringBoot集成Knife4j提示404 Error Page及SpringBoot3.X使用Knife4j生成分模块接口

报错问题解释:

SpringBoot集成Knife4j时出现404 Error Page通常意味着Knife4j的接口文档页面无法正常访问。可能的原因包括:

  1. 路径不正确:访问的路径与Knife4j的默认路径不一致。
  2. 依赖未正确引入或版本不兼容:可能是缺少相关依赖,或者依赖版本与SpringBoot版本不兼容。
  3. 配置错误:可能是Swagger配置或Knife4j配置不正确。

解决方法:

  1. 确认访问路径:确保访问的路径是/doc.html或者是你自定义的接口文档路径。
  2. 检查依赖:确保已经正确引入了Knife4j的依赖,并检查是否有版本冲突。
  3. 检查配置:检查Swagger和Knife4j的配置是否正确,包括扫描的包路径、API信息等。
  4. 检查SpringBoot版本:确保SpringBoot版本与Knife4j版本兼容。
  5. 检查安全配置:如果有安全配置(如Spring Security),确保Knife4j的文档路径没有被拦截。

针对SpringBoot 3.X使用Knife4j生成分模块文档,确保Knife4j版本支持SpringBoot 3.X,并且在配置时指定模块名称,如下:




@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfiguration {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .pathMapping("/")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo())
                .groupName("模块名"); // 指定模块名
    }
 
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("示例API文档")
                .description("这是一个示例API文档")
                .version("1.0")
                .build();
    }
}

确保basePackage中的包路径是正确的,并且在多模块项目中为每个模块配置不同的groupName

最后修改于:2024年09月09日 11:26

评论已关闭

推荐阅读

Vue中使用mind-map实现在线思维导图
2024年08月04日
VUE
Web前端最全Vue实现免密登录跳转的方式_vue怎么样不登录返回首页,最强技术实现
2024年08月04日
VUE
vue3 项目搭建教程(基于create-vue,vite,Vite + Vue)
2024年08月04日
VUE
Vue-颜色选择器实现方案——>Vue-Color( 实战*1+ Demo*7)
2024年08月04日
VUE
Vue项目卡顿慢加载?这些优化技巧告诉你!_vue数据多渲染卡顿
2024年08月04日
VUE
vue中的keep-alive详解与应用场景
2024年08月04日
VUE
Vue、React实现excel导出功能(三种实现方式保姆级讲解)
2024年08月04日
vue-office/docx插件实现docx文件预览
2024年08月04日
VUE
java调用js文件的两种方法(支持V8引擎)
2024年08月04日
JavaScript:解决计算精度问题/mathjs/bignumber.js/big.js/decimal.js
2024年08月04日
两周从爬虫小白变大神 _yjs_js_security_passport
2024年08月04日
JS笔记(对象、函数、数组)
2024年08月04日
Markdown.js:强大的纯JavaScript Markdown解析器
2024年08月04日
Vue项目:js模拟点击a标签下载文件并重命名,URL文件地址下载方法、请求接口下载文件方法总结。
2024年08月04日
vue 父组件怎么获取子组件里面的data数据
2024年08月04日
VUE
个人开发实现AI套壳网站快速搭建(Vue+elementUI+SpringBoot)
2024年08月04日
el-table 表格封装并改造实现单元格可编辑
2024年08月04日
none
nodejs环境下创建vue项目、SSH密钥登陆!!!
2024年08月04日
vue+quill+element-ui实现视频、图片上传及缩放保姆级教程,轻松使用富文本
2024年08月04日
【three.js】22. Imported Models导入模型
2024年08月04日