Spring Boot+React项目PUT:/update接口404错误排查求助

核心排查点： #

• 前端请求路径错误：你当前请求的是http://localhost:5173/employees/update，但后端服务运行在8080端口，正确的请求目标应该是后端地址http://localhost:8080/employees/update。如果前端配置了代理（比如Vite的proxy或Create React App的proxy），则应使用相对路径/employees/update发起请求，而非前端自身的端口地址——前端服务器没有这个接口，必然返回404。

• 后端控制器映射不匹配：

  • 检查控制器类上的类级注解，比如如果控制器标注了@RequestMapping("/api")，则实际接口路径应为/api/employees/update，而非/employees/update。
  • 确认PUT接口的注解：控制器方法必须使用@PutMapping("/employees/update")（或对应类级前缀后的路径），不能误用@PostMapping或其他请求方法注解。
  • 检查参数绑定：如果接口需要通过路径传递id（比如@PutMapping("/employees/update/{id}")），但前端请求路径未携带id，也会导致路径不匹配触发404。

• 跨域配置遗漏PUT方法：虽然其他CRUD接口正常，但仍需确认跨域配置是否允许PUT请求。检查Cors配置类中是否添加了HttpMethod.PUT，比如：

  corsConfiguration.addAllowedMethod(HttpMethod.PUT);
  

• 请求方法不匹配：确认前端Axios调用使用的是put方法，而非post或其他，示例：

  axios.put('/employees/update', employeeData, { params: { id: employeeId } })
  

内容的提问来源于stack exchange，提问作者Harihar Nagarajan