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

评论已关闭

推荐阅读

DDPG 模型解析,附Pytorch完整代码
2024年11月24日
DQN 模型解析,附Pytorch完整代码
2024年11月24日
AIGC实战——Transformer模型
2024年12月01日
Socket TCP 和 UDP 编程基础(Python)
2024年11月30日
python , tcp , udp
如何使用 ChatGPT 进行学术润色?你需要这些指令
2024年12月01日
AI
最新 Python 调用 OpenAi 详细教程实现问答、图像合成、图像理解、语音合成、语音识别(详细教程)
2024年11月24日
ChatGPT 和 DALL·E 2 配合生成故事绘本
2024年12月01日
omegaconf,一个超强的 Python 库!
2024年11月24日
【视觉AIGC识别】误差特征、人脸伪造检测、其他类型假图检测
2024年12月01日
[超级详细]如何在深度学习训练模型过程中使用 GPU 加速
2024年11月29日
Python 物理引擎pymunk最完整教程
2024年11月27日
MediaPipe 人体姿态与手指关键点检测教程
2024年11月27日
深入了解 Taipy:Python 打造 Web 应用的全面教程
2024年11月26日
基于Transformer的时间序列预测模型
2024年11月25日
Python在金融大数据分析中的AI应用(股价分析、量化交易)实战
2024年11月25日
AIGC Gradio系列学习教程之Components
2024年12月01日
Python3 `asyncio` — 异步 I/O,事件循环和并发工具
2024年11月30日
llama-factory SFT系列教程:大模型在自定义数据集 LoRA 训练与部署
2024年12月01日
Python 多线程和多进程用法
2024年11月24日
Python socket详解,全网最全教程
2024年11月27日