Knife4j文档请求异常404怎么解决

Knife4j是一款用于Spring Boot快速生成Swagger2文档的工具，当遇到文档请求404错误时，通常是由于以下几个原因：

1. **路径未映射**：确认你的API是否已经在Spring Boot的`@RestController`上进行了正确的注解，并配置了对应的请求路径。例如，`@GetMapping("/api/test")`。

2. **Controller类未扫描**：如果API是在自定义包下的，需要确保已经添加到Spring Boot的`@ComponentScan`注解中或者应用的自动扫描路径内。

3. **Swagger配置错误**：检查`application.yml`或`application.properties`文件内的Swagger配置，如`knife4j.swagger.path-mapping`、`knife4j.scan.package`等是否设置正确。

4. **版本冲突或更新问题**：如果之前有过API结构变更，可能会导致新的路径未被旧版本的文档引用。确保Swagger配置中使用的版本信息与实际运行的版本一致。

5. **Swagger UI访问路径**：确认你访问的是正确的地址，通常会是类似`http://localhost:8080/swagger-ui.html`这样的URL。如果应用部署到了其他服务器，记得替换为实际的URL。

如果你已经排查以上方面，仍然存在问题，可以尝试清除Swagger的缓存或者重启应用，有时候这能解决问题。如果问题依然存在，建议查看项目日志以获取更详细的错误信息。

相关问题

knife4j文档请求异常 404

解决Knife4j文档请求异常404的问题，可以按照以下步骤进行操作。首先，分析原因可以通过打开F12开发者工具，查看请求接口是否返回404未找到异常。接下来，找到对应业务的启动类，在该类上加上@EnableSwagger2WebMvc注解，然后重启应用即可解决该问题。\[1\]

另外，为了正常使用Knife4j生成API接口文档，需要引入相应的jar包。具体的依赖如下所示：

<!--Swagger-UI API文档生产工具-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>
<!--swagger增强工具依赖包，方便生成接口文档。非必须导入-->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>2.0.8</version>
</dependency>

确保以上依赖已正确引入。\[2\]

此外，如果你在后端代码中使用了返回后端数据统一注解ResponseResult，并且需要在WebMvcConfigurer/WebMvcConfigurationSupport中注入拦截器，可以考虑不破坏启动类的干净，以保证正常运行。\[3\]

通过以上步骤，你应该能够解决Knife4j文档请求异常404的问题。
#### 引用[.reference_title]
- *1* [Knife4j文档请求异常](https://blog.csdn.net/weixin_52914457/article/details/120999070)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^koosearch_v1,239^v3^insert_chatgpt"}} ] [.reference_item]
- *2* *3* [整合Knife4j生成文档后端接口文档出现404无法找到doc.html](https://blog.csdn.net/jianxia801/article/details/114288604)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^koosearch_v1,239^v3^insert_chatgpt"}} ] [.reference_item]
[ .reference_list ]

Knife4j文档请求异常

根据引用，当没有添加@Configuration时，会导致Knife4j文档请求异常。这意味着在启动项目时，如果尝试访问Knife4j接口请求文档，可能会出现错误。为了解决这个问题，你可以添加@Configuration注解来配置Knife4j。此外，根据引用，你可以通过访问localhost:8888/doc.html来访问Knife4j文档。如果你对Knife4j更感兴趣，可以参考引用提到的一篇博文，其中介绍了Knife4j swagger的更多内容。<span class="em">1</span><span class="em">2</span><span class="em">3</span>
#### 引用[.reference_title]
- *1* *2* [全网多种方式解决Knife4j文档请求异常](https://blog.csdn.net/lvoelife/article/details/129057354)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v92^chatsearchT0_1"}}] [.reference_item style="max-width: 50%"]
- *3* [swagger文档以及knife4j文档](https://download.csdn.net/download/m0_66884848/85069553)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v92^chatsearchT0_1"}}] [.reference_item style="max-width: 50%"]
[ .reference_list ]