当url查询参数中包含逗号时，传统?params=a,b,c格式会导致服务端错误分割（如公司名中的逗号被误判为分隔符），造成list长度异常；根本解法是改用post请求体传递json数组。
在Web开发中，将客户端数据以列表形式传递至后端时，开发者常倾向于使用URL查询参数（Query String）进行序列化，例如：
GET /api/search?params=[First_value],[Anhui Jantene Hone Textiles Co., Ltd.],[Third_Value]
然而，HTTP规范并未定义方括号[]或自定义分隔符的语义，实际解析完全依赖服务端框架（如Spring Boot的@RequestParam List
// 前端实际发送（含空格与逗号） GET /api/search?params=[first_value],[Anhui Jantene Hone Textiles Co.], [Ltd.],[Third_Value]
服务端收到的原始参数值为：
"[first_value],[Anhui Jantene Hone Textiles Co.], [Ltd.],[Third_Value]"
经逗号分割后得到4个元素，而非预期的3个。
✅ 正确实践：弃用URL参数传List，改用POST + JSON Body
将结构化列表数据置于请求体中，利用JSON天然支持嵌套与转义的特性，彻底规避分隔符歧义：
POST /api/search HTTP/1.1 Content-Type: application/json
{
"params": ["First_value", "Anhui Jantene Hone Textiles Co., Ltd.", "Third_Value"]
}后端Java（Spring Boot）接收示例：
@PostMapping("/api/search")
public ResponseEntity<?> handleSearch(@RequestBody SearchRequest request) {
List<String> params = request.getParams(); // 自动反序列化，逗号安全
// ...
}
public class SearchRequest {
private List<String> params;
// getter/setter
}⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- 不要尝试对URL参数做“手动编码+自定义解析”（如用%2C代替逗号再特殊处理），这违反REST语义且极易出错；
- 若必须用GET（如需缓存或书签），可改用多个同名参数：?params=First_value¶ms=Anhui%20Jantene%20Hone%20Textiles%20Co.%2C%20Ltd.¶ms=Third_Value，Spring会自动聚合为List，但需确保前端正确编码（尤其逗号需为%2C）；
- 始终优先选择语义清晰、框架原生支持的方案：复杂结构 → 请求体；简单标量 → 查询参数。
总结：URL查询字符串本质是扁平键值对集合，不适用于传输带分隔符的复合数据。坚持“数据结构决定传输方式”的设计原则，能从根本上避免此类序列化陷阱。
