jQuery Ajax提交参数routerIP末尾自动追加逗号问题排查

开发者阿泽

2026-8-26

问题原因

这个末尾多逗号的现象不是框架正常行为，是前后端请求配置不匹配导致的解析异常：
你当前的前端代码存在逻辑冲突：使用jQuery.param()将参数序列化为key=value格式的表单编码字符串，却手动将Ajax请求的contentType设置为text/plain。
Spring MVC默认的参数解析逻辑仅在contentType为application/x-www-form-urlencoded时，才会按照表单键值对规则拆分参数。当识别到请求类型是text/plain时，解析器会将整个请求体视为原始文本，@RequestParam注解在提取参数时会误将单值判定为多值场景，按照多值拼接规则自动在末尾追加逗号分隔符。浏览器抓包显示参数正常是因为前端发送的载荷本身没有问题，异常完全出在后端参数解析环节。

修复方案

优先修复（改动最小，无兼容问题）：删除前端Ajax请求中手动配置的contentType: 'text/plain'项，使用jQuery POST请求默认的application/x-www-form-urlencoded; charset=UTF-8编码类型即可，和jQuery.param()的序列化结果完全匹配，改完后Spring MVC会正常解析参数，不会再出现多余逗号。
核心请求配置参考：
```
$.ajax({
  url: '/verifyRouterIP',
  method: 'POST',
  data: $.param({routerIP: inputRouterIP}),
  beforeSend: function(xhr) {
    xhr.setRequestHeader(csrfHeaderName, csrfTokenValue);
  },
  dataType: 'text',
  success: function(resp) {
    // 原有展示校验结果、加载命令输入区的逻辑
  }
});
```
兜底临时修复：如果暂时无法调整前端请求配置，可以在后端Controller层接收参数后，手动剔除末尾的多余逗号，示例代码：
```
@PostMapping("/verifyRouterIP")
public String verifyRouterIP(@RequestParam String routerIP) {
    // 移除末尾多余逗号
    routerIP = routerIP.replaceFirst(",$", "");
    // 原有IP校验、业务逻辑
}
```
注意这个方案只是补丁，无法覆盖其他参数可能出现的同类解析问题，还是建议优先调整前端contentType配置从根源解决。