urlsearchparams构造函数可直接传入普通对象，但仅支持字符串或数组值，需预处理非字符串和嵌套结构；自动编码特殊字符，null/undefined会转为字面量字符串，建议过滤或转换。
直接用 URLSearchParams 构造函数传入普通对象即可，但要注意：它只接受键值对为字符串或数组的结构，不支持嵌套对象或非字符串值（如数字、布尔值、null），需先做简单预处理。
基础用法：对象必须是扁平的字符串键值对
URLSearchParams 接收一个类对象（如 plain object 或数组），其中所有值都会被自动转为字符串并编码。例如：
const params = new URLSearchParams({
name: '张三',
age: 25,
city: '北京&上海'
});
console.log(params.toString()); // "name=%E5%BC%A0%E4%B8%89&age=25&city=%E5%8C%97%E4%BA%AC%26%E4%B8%8A%E6%B5%B7"
注意：age: 25 会被自动转成字符串 "25"；特殊字符（如 &）也自动编码，无需手动 encodeURIComponent。
处理非字符串值（number/boolean/null/undefined）
虽然 URLSearchParams 会隐式调用 toString()，但 null 和 undefined 会变成字符串 "null" 或 "undefined"，通常不符合预期。建议提前过滤或转换：
- 排除
undefined和null值 - 将
boolean转为"true"/"false"（或按需转为"1"/"0"） - 数组可直接传入（会自动重复键名，如
tags[]=a&tags[]=b），也可用append手动控制
推荐预处理函数：
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
function objToSearch(obj) {
const cleaned = {};
for (const [k, v] of Object.entries(obj)) {
if (v == null) continue;
cleaned[k] = v.toString();
}
return new URLSearchParams(cleaned).toString();
}
处理嵌套对象或复杂结构
URLSearchParams 本身不支持嵌套（如 { user: { name: 'A', id: 1 } }）。若需序列化深层结构，必须先扁平化或使用 JSON 字符串（再编码）：
- 扁平化：自行递归展开，例如转成
user.name=A&user.id=1 - JSON 方案：将子对象
JSON.stringify后再encodeURIComponent，如filter=%7B%22status%22%3A%22active%22%7D
简单场景下，更常用的是只序列化顶层字段，深层数据建议走 POST body 或额外参数字段。
兼容性与替代方案
URLSearchParams 在现代浏览器（Chrome 49+、Firefox 29+、Safari 10.1+、Edge 16+）中已原生支持。如需兼容 IE，可用 polyfill（如 webmodules/url-search-params）或手写简易实现：
function simpleEncode(obj) {
return Object.entries(obj)
.filter(([, v]) => v != null)
.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
.join('&');
}
这个版本更轻量，且完全可控，适合简单需求。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
