Python中OData查询URL的正确编码方法及编码类型咨询

我之前也踩过这个坑——直接用urllib.parse.quote对整个查询字符串编码确实会过度处理，把OData语法里的$、=这些关键符号也转成编码，导致服务器无法识别查询规则。下面给你两种靠谱的解决方法，顺便解答你关于编码类型的疑问：

一、正确的编码方式：拆分处理参数名和值 #

OData的查询规则里，$filter、$select这类带$的是系统查询参数名，属于URL的语法部分，不能编码；真正需要编码的是参数值里的特殊字符（比如空格、特殊符号等）。Python的urllib.parse模块里的urlencode方法正好能帮我们做这个拆分处理：

单参数示例 #

import urllib.parse

# 定义OData查询的键值对，键保留OData原语法
odata_params = {
    '$filter': 'datecolumn gt 2019-01-01T00:00:00Z'
}

# 使用urlencode编码，仅对参数值做URL编码，参数名保持原样
# 用quote_via=urllib.parse.quote确保空格转成%20（默认是+，部分OData服务器也支持+，但%20更通用）
encoded_params = urllib.parse.urlencode(odata_params, quote_via=urllib.parse.quote)

# 拼接完整URL
endpoint = 'https://your-odata-service-endpoint'
full_odata_url = f"{endpoint}?{encoded_params}"

运行后encoded_params会得到：$filter=datecolumn%20gt%202019-01-01T00%3A00%3A00Z，完全符合你需要的格式。

多参数示例（比如同时用$filter和$select） #

如果有多个查询参数，直接把所有键值对放进字典即可：

odata_params = {
    '$filter': 'datecolumn gt 2019-01-01T00:00:00Z',
    '$select': 'id,name,datecolumn',
    '$top': 100
}
encoded_params = urllib.parse.urlencode(odata_params, quote_via=urllib.parse.quote)
# 结果会自动用&拼接：$filter=...&$select=...&$top=100

二、关于OData的编码类型 #

OData请求使用的就是标准的URL百分比编码（对应HTTP的application/x-www-form-urlencoded媒体类型），没有特殊的专有编码名称。唯一需要注意的就是：OData的系统查询参数名（带$的那些）属于URL的结构部分，不能被编码，只有参数值需要按标准URL编码规则处理。

为什么之前的方法失效？ #

urllib.parse.quote是对整个字符串做编码，会把?、$、=这些URL结构符号也转换成编码（比如$变成%24），而OData服务器需要识别这些符号来解析查询规则，所以直接编码整个字符串会导致查询失效。

内容的提问来源于stack exchange，提问作者Maile Cupo