查询参数里的加号为什么变成了空格
沿浏览器、服务端与第三方的链路解释 form 编码、重复参数和签名 URL,用断言定位加号丢失与二次编码。

搜索框里输入 a+b c,结果页读到的却是 a b c。修复这类问题,先分开两件事:程序中的原始值,以及传输中的查询字符串。原始值交给 set 或 append;查询字符串交给解析器。混用这两个入口,加号会丢,百分号也可能多出一层。
假设一个搜索页面要把关键词和两个标签交给服务端,再由服务端转发给第三方。下面沿着这条链路看字符在哪一步变化。第三方地址是示例域名,本地运行验证的是编码与解析行为。
加号的含义由解析规则决定
百分号编码用 %HH 表示字节,%2B 对应加号。把裸 + 解释为空格,则来自 application/x-www-form-urlencoded 的规则。WHATWG URL 标准的解析步骤先按 & 分隔,再按第一个 = 分出名称和值,接着把裸加号换成空格,最后执行百分号解码和 UTF-8 解码。URLSearchParams 的字符串入口采用这套规则。
因此,一次解析得到以下结果。顺序很关键:由 %2B 解出的加号不会回到前面的步骤再次变为空格。
| 查询字符串中的值 | 解析一次后的值 | 含义 |
|---|---|---|
+ | 一个空格 | form 规则中的空格 |
%2B | + | 字面加号 |
%252B | %2B | 字面百分号加上 2B |
%20 | 一个空格 | 百分号编码的空格 |
不能据此说所有 URL 中的加号都等于空格。路径 /a+b、decodeURIComponent("a+b") 都保留加号;查询部分是否这样解释,要看接收方的协议与解析器。浏览器地址栏显示的文本也不能替代服务器实际收到的请求。
浏览器传值 服务端解析 第三方重新构造
const input = "a+b c";
const browserURL = new URL("https://app.example/search");
browserURL.searchParams.set("q", input);
browserURL.searchParams.append("tag", "C++");
browserURL.searchParams.append("tag", "a b");
console.log(browserURL.search);
// ?q=a%2Bb+c&tag=C%2B%2B&tag=a+b
// 服务端示例;实际框架的 query 对象往往已经解析过
const received = new URL(browserURL.href).searchParams;
const q = received.get("q"); // "a+b c"
const tags = received.getAll("tag"); // ["C++", "a b"]
const outbound = new URL("https://api.example/search");
outbound.searchParams.set("q", q);
for (const tag of tags) outbound.searchParams.append("tag", tag);
console.assert(outbound.search === browserURL.search);
console.assert(new URL(outbound.href).searchParams.get("q") === input);

原始值跨过两次传输边界,字面加号仍然保留。
这里的“一次”指每个边界各解析或序列化一次,并非整个系统只能调用一次 API。如果框架已经把查询解析成 q,业务代码直接使用这个值。不要再调用 decodeURIComponent(q),也不要把它拼成 new URLSearchParams("q=" + q):后者会把值中的加号当成查询语法。
反过来,set("q", encodeURIComponent(input)) 会把已经编码的文本当成原始值,生成 q=a%252Bb%2520c。接收端解析一次只得到 a%2Bb%20c。若输入本来就包含字面文本 %2B,输出 %252B 则完全合理;排错前必须先确认业务值应该是什么。
完整 URL 用 new URL(address).searchParams 读取。new URLSearchParams(address) 不会识别主机、路径和片段,它只把整个输入按查询语法处理。MDN 的 URLSearchParams 示例说明了这两种入口的差别。
Base64 和重复参数要有明确协议
标准 Base64 可能包含 +、/ 和 =。例如,把 E+AXQB+A 直接拼成 token=E+AXQB+A,form 解析后会得到 E AXQB A。用 set("token", token),输出是 token=E%2BAXQB%2BA,接收方才能还原。若协议指定 Base64url,按其字母表与 padding 约定生成;不能仅因加号麻烦就擅自更换令牌格式。
重复参数同样需要双方约定。get("tag") 只返回第一项,getAll("tag") 返回全部,append 增加一项,set 会合并同名项并删除其他值。框架可能采用最后一项、数组或拒绝重复项,不能把浏览器 API 的行为自动当成服务端协议。对于只允许一个值的字段,应检查数量再接受;对于标签,按约定保留数组与顺序。转发时循环 append,不要经由 Object.fromEntries 把重复值压掉。
签名 URL 要保留签名约定的字节
相同的解析值不保证相同的查询字符串。下面甚至没有交换参数顺序,sort 仍会触发重序列化:
const u = new URL("https://cdn.example/image?q=a%20b~&tag=1&tag=2");
const original = u.search;
u.searchParams.sort();
console.log(original); // ?q=a%20b~&tag=1&tag=2
console.log(u.search); // ?q=a+b%7E&tag=1&tag=2
空格从 %20 变成 +,~ 变成 %7E。如果签名覆盖原始查询字节,这次变化会改变签名输入;本地 HMAC 断言也得到不同摘要。实际签名方案可能规定参数排序、重复项顺序、转义字符集、大小写以及签名字段是否排除。按供应方的 canonicalization 或 SDK 操作;收到已签名地址后,保留其完整形式直接使用。必须修改时,依协议重新生成签名。不能把“解析值一样”当成签名仍有效的证据。
按边界找到第一次变化
排错时依次比对输入值、浏览器实际请求的查询、服务端原始查询与解析值、发往第三方的查询。令牌或签名不进入日志;普通测试值可以用 JSON.stringify 显示空格。找到第一次变化的位置,再检查这一处的输入属于值还是编码文本。
可在 Node 或浏览器控制台运行这组断言:
console.assert(new URLSearchParams("q=a+b").get("q") === "a b");
console.assert(new URLSearchParams("q=a%2Bb").get("q") === "a+b");
console.assert(new URLSearchParams("q=%252B").get("q") === "%2B");
const p = new URLSearchParams();
p.set("q", "a+b c");
console.assert(p.toString() === "q=a%2Bb+c");
console.assert(new URLSearchParams(p.toString()).get("q") === "a+b c");
console.assert(decodeURIComponent("a+b") === "a+b");
这组结果把解析规则、字面加号和往返值分别固定下来。接口接通后,再用同样的测试值核对实际框架与第三方,尤其检查重复参数和签名约定。