把一串符号放进URL编码工具,有些变成百分号编码,感叹号、星号、单引号和括号却原样留下。结果没变不一定是转换没执行,而是当前编码函数允许这几个字符保持原样。

本文用URL编码解码核对三组公开符号,重点区分JavaScript组件编码与某些接口要求的严格转义。中文参数、加号和重复编码的基础操作可参照URL参数转换说明,这里不再重复这些步骤。

先输入一组会保持原样的字符

保持“URL 编码”,输入:

!*'()~_-.
当前工具的输入和输出相同,这组符号在组件编码中没有全部转成百分号形式
当前工具的输入和输出相同,这组符号在组件编码中没有全部转成百分号形式

本次输出仍是 !*'()~_-.。页面采用的组件编码规则允许这些字符原样出现,因此不能用“输出还有标点”判断失败。

这里应区分两组字符:~_-. 属于常见的非保留字符;!'()* 虽然也被JavaScript的 encodeURIComponent 保留,但在RFC3986的字符分类中与它们不是同一类。某些签名算法或接口的规范化步骤会要求继续处理后一组。

这不代表在所有URL里都必须把标点全部编码。一个字符能否原样使用,还要看它位于路径、查询参数、片段还是其他组件,以及接收方怎样定义编码过程。工具不会根据业务接口自动切换一套签名规则。

结构分隔符会有不同结果

第二组输入:

/?:@&=+$,#[] 

最后一个字符是空格。

本次斜杠、问号、冒号等符号被转为百分号编码,末尾空格为百分20
本次斜杠、问号、冒号等符号被转为百分号编码,末尾空格为百分20

本次结果为:

%2F%3F%3A%40%26%3D%2B%24%2C%23%5B%5D%20

这一组显示编码确实在执行。斜杠、问号、等号等符号在不同URL位置承担结构作用,组件编码把它们作为某个值的内容进行转义。若直接把完整网址放进来,网址结构也可能被编码,不能拿生成的整串替换原本准备访问的地址。

对接API时,先查清楚需要编码的是一个参数值、一个路径片段,还是整个URL作为外层参数的值。输入对象不同,即使使用同一个函数,正确的调用位置也不同。

严格形式也能被解码回来

切到“URL 解码”,输入:

%21%2A%27%28%29~_-.
将前五个符号写成百分号形式后,本次解码仍恢复为原始符号序列
将前五个符号写成百分号形式后,本次解码仍恢复为原始符号序列

本次输出回到 !*'()~_-.。两种文本表现可以表示同样的字符,但如果接口对请求原文做规范化和签名,字符表示形式的差异仍可能影响参与计算的字符串。

如果接口明确要求按RFC3986对组件补充转义,可以在本地按约定处理,例如:

function encodeComponent3986(value) {
  return encodeURIComponent(value).replace(/[!'()*]/g, char =>
    "%" + char.charCodeAt(0).toString(16).toUpperCase()
  );
}
console.log(encodeComponent3986("!*'()~_-."));
// %21%2A%27%28%29~_-.

这个示例只是组件编码步骤,不包含签名字段排序、路径规范化、空值处理或摘要计算,不能直接当成任何云厂商签名算法的完整实现。应以对接方当前文档中的字符集、大小写和拼接规则为准。

排查签名不一致时,保留编码前文本与最终参与签名的字符串,逐个核对字符,不要先把所有百分号形式解开再比较。能解码成同样内容,只能说明字符值一致,不能证明两份待签名原文逐字相同。