作者 Yiyao发布于 更新于
使用前先读懂编码值
粘贴百分号编码的值,并选择解释方式。路径片段或独立编码值使用 URI 组件模式;表单编码数据中以加号表示空格时,使用表单值模式。点击解码,每次只处理一层编码。
在将值放入请求或配置前,可以通过输出理解其含义。解码完整 URL 可能使编码字符变成分隔符,因此复制前应确认需要使用的是哪一个组成部分。
选择正确的解码模式
百分号转义表示编码后的字节。在 UTF-8 中,多个转义字节可能共同组成一个字符。所选模式决定在百分号解码前如何处理字面的加号。
| 模式 | 输入示例 | 解码结果 | 适用场景 |
|---|---|---|---|
| URI 组件 | red+chair%20sale | red+chair sale | + 为字面字符的独立编码组件 |
| 表单值 | red+chair%20sale | red chair sale | + 表示空格的表单编码值 |
| 任一模式 | %2B | + | 明确使用百分号编码的加号 |
| 任一模式 | %252F | %2F | 只解码一次,不自动解码剩余转义 |
保留 URL 的结构边界
查询参数值可能包含同时具有 URL 结构含义的字符。例如,编码后的 & 可能属于搜索词内部,而不是两个查询参数之间的分隔符。
例如,查询值 red%26blue 解码后是 red&blue。再次发送同一个值时,应使用请求客户端的参数构建功能,让 & 作为值的一部分被正确编码。将解码文本直接拼入完整 URL,可能改变查询参数的解析方式。
检查完整地址时,应先识别协议、主机、路径和查询参数。只解码所需的组成部分,不要把完整地址当作可以随意替换的字符串。
有针对性地处理无效输入
不完整的百分号转义或非法 UTF-8 序列无法在此模式下解码。请检查值是否被截断、是否误复制了百分号,或来源是否使用了其他字符编码。
排查时保留原始值。只有了解生成系统的编码行为时,才逐层解码。反复解码直到结果看起来熟悉,可能改变原始数据的含义。
| 情况 | 显示提示 | 下一步 |
|---|---|---|
| 输入为空 | 请输入要解码的文本。 | 粘贴一个值或使用示例 |
| 转义格式错误或 UTF-8 无效 | 无法解码:请检查百分号转义和 UTF-8 输入。 | 检查原始来源是否被截断或使用不同编码 |
| 输入超过 100000 个字符 | 请输入不超过 100000 个字符。 | 选择更小的组成部分进行检查 |
| 复制不可用或被拒绝 | 无法复制,请选中输出并手动复制。 | 保留可选中的输出结果 |
使用安全的请求示例
公开数据流程可能返回 product%20name%3Ddesk%20lamp 这样的筛选值,解码后为 product name=desk lamp,有助于理解存储内容。比较日志或准备可复现示例时,应将原始值与解码视图一起保留。
构建新请求时,应通过客户端库传入参数名和值,不要手动拼接解码片段。在运行更大规模的授权任务前,检查生成的 URL 和响应。共享调试示例时,请使用虚构数据。
URL 解码常见问题
为什么 + 没有改变?URI 组件模式会保留字面的加号。只有来源以加号表示空格时,才应选择表单值模式。
为什么 %252F 变成 %2F 而不是斜杠?工具每次只解码一层。第二层需要单独、明确地再次解码。
解码会向该地址发送请求吗?不会。输出以文本形式显示,工具不会打开目标地址。
可以粘贴秘密令牌吗?排查时请使用脱敏或虚构示例。凭据应保留在专门的安全配置流程中。
