URL编码开发中的常见错误

URL 编码又叫百分号编码（Percent-Encoding），定义在 RFC 3986 中：把 URL 里不允许直接出现的字符先转成 UTF-8 字节，再把每个字节写成“%”加两位十六进制数，例如空格写成 %20，“中”写成 %E4%B8%AD。下面重点说明报错与纠正。

URL编码开发中的常见错误

• URIError: URI malformed（JS decodeURIComponent）：字符串里有不完整的 % 序列，如“%E4%B8”
• 参数被截断：值里的“&”没有编码，被当成了参数分隔符
• 服务端收到乱码：两端字符集不一致（UTF-8 与 GBK）
• 签名校验失败：编码时空格用了“+”而规范要求 %20，或十六进制大小写不一致

示例

输入：user@example.com

编码结果：user%40example.com

说明：按 RFC 3986 编码，空格为 %20，中文按 UTF-8。

工作原理

浏览器或程序逐个检查字符：属于非保留字符的原样保留；其余字符先按 UTF-8 转成字节，每个字节输出为“%XX”（大写十六进制）。例如“问”的 UTF-8 字节是 E9 97 AE，编码后为 %E9%97%AE。

Go 示例

下面是 Go 中处理URL编码的常用写法：

import "net/url"
url.PathEscape("123问 a&b")   // 123%E9%97%AE%20a&b（路径段，保留 &）
url.QueryEscape("a b&c")      // a+b%26c（查询参数）

运行前确认输入的字符集（推荐 UTF-8），结果可以用本站工具交叉核对。

本站的URL编码解码工具可以直接处理，计算在浏览器本地完成，适合快速核对结果。

常见问题

【为什么中文变成了三组 %XX？】中文按 UTF-8 编码，常用汉字占 3 个字节，每个字节写成一个 %XX。

【URL 编码能防止 XSS 吗？】不能完全防止。URL 编码只解决网址格式问题，输出到网页时还需要做 HTML 转义。

【出现 %25 是怎么回事？】“%”被再次编码成了 %25，说明发生了重复编码。

文中示例可以在本站对应工具中验证；处理密钥、证书等敏感数据时，请注意保护隐私。

标签： 编码 数码开发