前端联调接口时,一个普通删除接口报错如下(使用丝袜哥):
接口代码如下:
@Slf4j
@Validated
@RestController
@RequestMapping("/sys/api/menu/")
@Api(tags = "菜单管理")
public class MenuController {
@Autowired
private IMenuService menuService;
@ApiOperation(value = "删除菜单/按钮", notes = "删除菜单/按钮")
@RequestMapping(value = "/{menuIds}", method = RequestMethod.DELETE)
public Result deleteMenus(@RequestParam(name = "menuIds", required = true) String menuIds) {
String[] ids = menuIds.split(FebsStringConstant.COMMA);
if (this.menuService.deleteMeuns(ids)) {
return Result.OK("删除菜单/按钮成功");
} else {
return Result.error("删除菜单/按钮失败");
}
}
.......
}
调用url修改为:http://localhost:8090/sys/api/menu/delete?menuIds=275 则调用成功。
问题分析,有两个原因导致:
-
使用的spring mvc注解不当,上面使用了@RequestParam,正确应该使用@PathVariable,至于这两注解区别可以参考https://blog.csdn.net/NKerbug/article/details/107848087?spm=1001.2014.3001.5502
根源自然是要看spring-webmvc.jar包源码:RequestParamMethodArgumentResolver和PathVariableMethodArgumentResolver -
从上面的错误产发现一个怪异的现象,就是请求url:http://localhost:8090/sys/api/menu/delete?menuIds=275,但是controller代码写的是DELETE http://localhost:8090/sys/api/menu/{menuIds},却能够请求成功并返回结果。
这这是什么鬼?思考一下问题还是得看spring-webmvc.jar包源码,提到spring mvc mapping核心自然是DispatcherServlet这个类,
核心方法非doDispatch莫属,看代码:
这里省略部分跟踪代码,跳到关键方法:
PatternsRequestCondition patterns = this.patternsCondition.getMatchingCondition(request);
最终会进到AntPathMatcher.doMatch进行url与接口method的mapping再次配对,之前已经进行了全路径匹对,全路径优先级是高于二次匹对。
最终,debug发现url会被切割成 sys api menu delete 四个字符串,循环与接口代码路径/sys/api/menu/{menuIds}匹对,发现能匹对上三个字符串,pathIdxStart=4(代表接口路径),pathIdxEnd=3(代表http请求路径),最后返回这个mapping对象,供MVC调用。
至此,就能解释请求url:http://localhost:8090/sys/api/menu/delete?menuIds=275,controller代码写的是DELETE http://localhost:8090/sys/api/menu/{menuIds},却能够请求成功并返回结果。