先确认适用条件

适用于 GET 查询里含空格、中文、加号或 &,手工拼接 URL 后参数被截断或服务器解析错误。本文处理请求参数编码与 HTTP 方法选择,不涉及账号权限或网络线路切换。

先区分原因与影响范围

引号保护的是 shell 对命令的解释,不等于把查询值做 URL 编码。& 可能被当作参数分隔符,+ 可能按表单规则表示空格。--data-urlencode 编码字段值,配合 --get 才把这些字段放到 GET 的查询部分。

按顺序检查,每次只改一项

  1. 先查接口文档,确认它接受 GET 查询还是 POST 表单,记录服务端实际识别到的字段。不要把接口明确要求的 POST 擅自改成 GET。
  2. 保留原始、尚未编码的字段值。每个字段单独用 --data-urlencode "name=value" 指定,字段名本身应使用接口要求的合法名称。不要把整个 name=value 字符串事先编码后又传一次。
  3. GET 场景加 --get,让参数追加到 URL;仅用 -X GET 只改方法名,不等价于把 -d 的正文移到查询字符串。
  4. 对公开、无敏感内容的测试字段做对照,比较服务器收到的值是否保留了空格、&、+ 和中文。认证令牌与密码不要放进 URL 查询,因为可能被日志和历史记录保存。
macOS / Linux shell;example.com 仅作 URL 占位,须换成你有权测试的 GET 接口;无需管理员权限
curl -q --get --data-urlencode "q=网络 A&B+C" --data-urlencode "page=1" --connect-timeout 10 --max-time 20 --output query-result.txt "https://example.com/search"

怎样确认已经恢复

服务器应把示例中的 q 识别为一个完整值,而不是多出一个字段或把 + 变成空格。HTTP 200 本身不能证明参数正确;需要应用响应或受控服务端记录来确认。

未恢复时如何回退与求助

本轮是单次命令参数改动,撤回即可。若接口要求已有的百分号编码字符串,按其协议处理,避免二次编码。返回 400 时保留脱敏后的字段名和错误体,不通过关闭 TLS 或改固件设置排查。