展项名称带空格和加号，HTTP 查询参数怎样编码才不串值

HTTP查询参数应由URL构造器按字段编码，不能直接把展项名称拼到问号后。数据中的&可能被误认成下一个参数，+在表单式查询解析中常被当作空格，中文也需要稳定编码。先明确双方使用的查询语法，再验证“原值→URL→解析值”的回环，确保名称一个字符都没有变化。

环境和证据范围

本文以常见application/x-www-form-urlencoded风格的查询解析约定举例，使用Python标准库quote与parse_qs；RFC3986本身并不把所有查询中的加号都规定为空格。附件只构造本地字符串，不访问任何地址，不在URL中放入令牌或用户信息。

核对顺序

1. 列出真实允许的名称样本，至少有空格、字面加号、中文、斜杠和&。把“展厅 A+B/1&2”当一个name值，不能拆成多个字段，也不能先手工替换一部分字符再交给编码器。

2. 按键值分别编码，再组成查询字符串，保持URL路径与参数值的处理分开。参数值中的斜杠可以编码为%2F，不要为了路径可读性意外将数据中的保留符号裸露。

3. 用与服务端相同约定的解析器解码一次，断言得到原始字符串。另加已经含百分号的名称，例如“完成率100%”，确认不会被误当预编码片段，也避免重复解码造成语义改变。

4. 保留原值和最终请求URL两个字段，错误时比较编码过程。实际设备可能用私有解析器；若回环脚本通过但设备仍串值，应向设备方索取原始解析日志，而不是不断增加替换规则。

可复算的输入与预期

附件三条原值为“展厅 A+B/1&2”“完成率100%”和“入口 空间”。生成的查询中，字面加号必须表现为%2B，&必须为%26，原本的百分号必须为%25；脚本逐条解码后与输入比较，并输出最终query供复制核对。

下载与现场记录

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 original_value、query_encoding_rule、request_url、server_parsed_value、round_trip_equal。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

失败分支与移交

把整个URL一次性quote会连冒号、斜杠、问号都编码，破坏URL结构；完全不编码则会丢失参数边界。某些接口的路径参数规则又不同，不能把本页查询约定照搬。参数重复出现时保留数组还是只取首项，也应另定，不应在排错时默认。

交付一个名称测试向量集和编码约定，标明空格的写法、重复键处理、字符编码及最大长度。现场报告保留最终URL但删除敏感凭据。任何业务响应都要再核对设备实际识别的展项ID，名称正确回环不代表权限和业务路由已经正确。

基础背景可看HTTP / RESTful 设备控制接口科普。请求到达后如果又发生跳转，再核对接口跳转后 POST 变成 GET，怎样核对 303、307 与 308。更多资料在设备协议库。

需要接入中控时，可对照SoftControl设备联动需求核实适配范围；独立校验方法是否纳入交付需逐项约定。

一级资料

• 官方资料：§2.1百分号编码与§2.2保留字符

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。