URLSearchParams的append和set,为什么会生成不同的查询结果?
多选了几个标签,最终地址里为什么只剩一个tag?先检查代码用的是append还是set。URLSearchParams可以保存同名的多个键值对,但这两个方法对重复键的处理不同,不是把某个参数名当作普通对象属性来理解就够了。
2026年11月19日,本次直接在Chrome中构造tag=a&x=1&tag=b,两份副本分别调用append和set,再保存生成的字符串与读取结果。实验没有发往真实业务接口,先把范围限定为浏览器API的构造和读取。
追加与替换保留了不同的条目
调用append('tag','c')后,查询串为tag=a&x=1&tag=b&tag=c;get('tag')取得第一项a,getAll('tag')则得到a、b、c。调用set('tag','c')后,结果是tag=c&x=1,同名的其他tag被移除。

这里不仅是值不同,条目的数量与顺序也需要保留。如果日志只把参数转换成单值对象,可能在你看到记录之前就已经丢失重复项;不能再用那份对象证明原始URL只有一个tag。
取第一项不等于确认只有一项
本例中get返回a,并不表示b和c没有生成。排查多选筛选、排序条件或批量标识时,先查看原始查询串和getAll,再决定应用是否允许重复键。后端框架可能采用不同的读取约定,本次没有替它们作统一结论。
append和set也不能解决所有值编码问题。参数值中如果包含分隔字符,仍应按正确的URL组件规则处理,不能靠手工拼接重复键来规避编码。条目数量与值本身如何编码,是需要分别核对的两件事。
可在URL编码解码检查具体参数值的编码,再用网站测速复测包含完整查询串的受控目标。提交给服务端之前,先明确约定要“增加一项”还是“更新这个键”,通常比在结果页反复找丢失标签更直接。