本文深入探讨了spring boot应用中restful api返回404错误的原因及解决方案，特别是当使用postman等工具进行接口测试时。核心问题通常源于对api路径的误解，包括类级别和方法级别的`@requestmapping`或特定http方法注解的组合方式。通过分析一个具体的mongodb产品管理案例，文章详细解释了如何正确构造api请求url，并提供了调试此类问题的通用方法和最佳实践，确保api能够被正确识别和访问。
在开发Spring Boot RESTful API时，遇到“404 Not Found”错误是一个常见但往往令人困惑的问题。这类错误通常表明服务器未能找到与请求URL匹配的资源。本文将通过一个具体的案例，详细分析导致404错误的原因，并提供一套系统的诊断和解决策略，帮助开发者快速定位并修复问题。
Spring Boot使用Spring MVC来处理HTTP请求，其核心在于通过注解将请求路径映射到特定的控制器方法。一个完整的API路径由以下几个部分组成：
最终的API路径是“应用上下文路径” + “控制器类级别路径” + “方法级别路径”的组合。
假设我们正在构建一个Spring Boot应用，用于管理产品信息并将其存储到MongoDB。我们定义了一个 ProductController 来处理产品的增删改查操作。
ProductController 代码示例：
package com.example.mdbspringbootproductorganizer.controller;
import java.util.List;
import java.util.Optional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.example.mdbspringbootproductorganizer.model.Product;
import com.example.mdbspringbootproductorganizer.repository.ProductRepository;
@RestController
@RequestMapping("/api") // 控制器类级别路径
public class ProductController {
@Autowired
private ProductRepository repository;
@PostMapping("/addProduct") // 方法级别路径
public String saveProduct(@RequestBody Product product) {
repository.save(product);
return "Added product with id : " + product.getId();
}
// ... 其他方法 ...
}在上述 ProductController 中：
因此，saveProduct 方法的完整API路径应该是 /api/addProduct。
遇到的问题： 当尝试使用Postman向 http://localhost:8080/mdb-spring-boot-product-organizer/api/addProduct 发送 POST 请求时，服务器返回了 404 错误：
{
"timestamp": "2022-12-07T22:56:33.866+00:00",
"status": 404,
"error": "Not Found",
"path": "/mdb-spring-boot-product-organizer/api/addProduct"
}问题分析： 从错误响应中可以看出，Spring Boot应用尝试匹配的路径是 /mdb-spring-boot-product-organizer/api/addProduct。然而，根据 ProductController 的定义，我们预期的API路径是 /api/addProduct。
这里的关键在于 mdb-spring-boot-product-organizer 这部分。在默认的Spring Boot配置中，如果没有在 application.properties 或 application.yml 中明确设置 server.servlet.context-path，应用程序会部署在根上下文路径 / 下。因此，mdb-spring-boot-product-organizer 不应作为URL的一部分。它很可能是项目名称或Maven/Gradle的Artifact ID，但并不会自动成为URL的上下文路径。
解决方案： 将Postman请求的URL修正为 http://localhost:8080/api/addProduct，并确保请求方法为 POST。
Postman请求示例：
请求方法 (Method): POST
请求URL (URL): http://localhost:8080/api/addProduct
请求头 (Headers): Content-Type: application/json
请求体 (Body - raw, JSON):
{
"id": 1,
"name": "Laptop",
"listedPrice": 1200.00,
"purchasePrice": 1000.00,
"condition": "New",
"brand": "Dell",
"shelf": "A",
"bin": 101
}除了上述案例中的路径误解，还有其他可能导致404错误的原因。以下是一些常见的调试技巧：
Spring Boot在启动时会打印所有映射的请求路径。仔细查看日志，可以确认你的API路径是否如预期般被注册：
...
s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/addProduct],methods=[POST]}" onto public java.lang.String com.example.mdbspringbootproductorganizer.controller.ProductController.saveProduct(com.example.mdbspringbootproductorganizer.model.Product)
...如果日志中没有找到你期望的映射路径，那么可能存在注解错误、组件扫描问题或启动失败。
确保你的控制器类位于Spring Boot应用主类 (@SpringBootApplication 所在类) 的包或其子包中，以便Spring能够自动扫描并注册它。如果控制器在不同的包结构中，可能需要使用 @ComponentScan 注解明确指定扫描路径。
Spring Boot中的404错误多数情况下是由于API路径配置或请求URL不匹配造成的。通过系统地检查应用上下文路径、控制器映射注解、HTTP方法、应用运行状态以及Postman请求配置，开发者可以高效地诊断并解决这类问题。理解Spring MVC的请求映射机制是避免此类错误的关键。
以上就是Spring Boot RESTful API 404 错误诊断与路径配置指南的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
816
收藏
