最可靠方法是用 urllib.parse.parse_qs 或 parse_qsl:前者返回值为列表的字典,适合多值参数;后者返回有序元组列表,支持空值和重复键,且自动处理 url 解码。

Python 中用 urllib.parse 解析 query string 最可靠
后端收到的原始请求字符串(比如 GET /search?q=python&sort=date&tag=web&tag=api 中的 q=python&sort=date&tag=web&tag=api)不是 JSON,也不是普通字典,直接用 dict(x.split('=') for x in s.split('&')) 会崩在空值、URL 编码、重复键上。
必须用标准库的 urllib.parse.parse_qs 或 parse_qsl:
-
parse_qs(s)返回{'q': ['python'], 'sort': ['date'], 'tag': ['web', 'api']}—— 所有值都是列表,适合处理多值参数(如多个tag) -
parse_qsl(s, keep_blank_values=True)返回[('q', 'python'), ('sort', 'date'), ('tag', 'web'), ('tag', 'api')]—— 保持顺序,可含空值,适合需逐项遍历或去重的场景 - 别用
urlparse.parse_query(不存在),也别手动.replace('+', ' ').decode('utf-8')——parse_qs内部已自动处理 URL 解码和编码边界
Node.js 里 URLSearchParams 是唯一推荐方案
Express 等框架的 req.query 虽方便,但那是框架层封装;如果你在纯 HTTP server、Cloudflare Worker 或 Fastify 的 raw handler 里拿到原始 query 字符串,就得自己解析。
浏览器和 Node.js ≥10 都原生支持 URLSearchParams,它比手写正则或 querystring.parse() 更健壮:
-
new URLSearchParams('a=1&b=&c=hello%20world')自动解码空格、加号、UTF-8 百分号编码 -
.get('b')返回''(不是undefined),.getAll('a')支持重复键,.has('c')安全判空 - 避免用过时的
querystring.parse():它把b=当作b: '',但把b(无等号)当作b: null,行为不一致且不兼容 URL 标准
Go 的 net/url.ParseQuery 默认不保留重复键
Go 标准库的 url.ParseQuery 返回 map[string][]string,看似支持多值,但注意:它对同一个 key 的多次出现是「追加」而非「覆盖」,这点没问题;真正容易踩坑的是它的错误处理逻辑 —— 遇到非法编码(如 %zz)直接返回 error,不会跳过或降级。
- 生产环境必须检查返回的
err,不能假设 query string 一定合法 - 若需容忍部分损坏参数(比如前端传错但你想尽量取可用值),得先用
url.PathEscape预清洗,或改用第三方库如github.com/gorilla/schema - 别用
strings.Split手动切 —— 无法区分a=b&c=d和a=b%26c%3Dd(后者其实是单个参数a="b&c=d")
PHP 的 parse_str() 必须配合 urldecode() 吗?
不需要。PHP 的 parse_str() 内部已自动处理 URL 解码,但有两个关键限制:
- 它把重复 key 当作覆盖(
a=1&a=2→$arr['a'] = '2'),不保留多值,除非你手动用parse_str(str_replace('&', '&', $s), $out)模拟,但这很 hack - 它默认不处理空值:当参数是
a=&b=1,$a是空字符串,但a缺失时不会设为null;业务中常需额外判断isset($a)还是array_key_exists('a', $arr) - 更稳的做法是用
$_GET(已由 SAPI 层解析好),仅在解析自定义 query 字符串时才调parse_str(),且务必传入第二个变量接收结果,避免污染当前作用域
所有语言都一样:query string 是客户端可控输入,解析只是第一步;后续必须做类型转换、范围校验、长度限制 —— 比如把 limit=9999999 当整数用之前,先确认它没超出业务允许的最大页长。










