使用Prometheus API调用含+运算符查询时遇无效参数错误

问题现象 #

• 执行Prometheus查询时，语句包含+运算符会抛出invalid parameter "query"解析错误，使用-、/、*等其他运算符无异常
• 该问题仅在Postman、Python requests库中出现，Grafana、Prometheus Web UI中查询完全正常
• 示例请求：

  GET http://<prometheus地址>/api/v1/query?query=count(up{instance=~".*:9100"} == 1) + 100
  

• 错误信息：

  {"status": "error", "errorType": "bad_data", "error": "invalid parameter \"query\": 1:39: parse error: unexpected number \"100\""}
  

• Prometheus版本：2.48.1

原因分析 #

HTTP协议中，URL参数里的+会被默认解析为空格。当你直接在Postman或Python requests中拼接带+的查询语句时，未对参数做编码处理，Prometheus收到的实际查询语句会变成count(up{instance=~".*:9100"} == 1) 100（+被替换成了空格），这不符合PromQL语法规范，因此触发解析错误。而Grafana和Prometheus Web UI会自动对URL查询参数做URL编码，将+转换为%2B，所以能正常执行查询。

解决方案 #

1. 手动编码替换 #

将查询语句中的+直接替换为URL编码后的%2B，示例请求修改为：

GET http://<prometheus地址>/api/v1/query?query=count(up{instance=~".*:9100"} == 1)%2B100

2. 工具自动编码 #

• Python requests：不要手动拼接URL，使用params参数传递查询语句，requests会自动完成URL编码：

  import requests
  
  url = "http://<prometheus地址>/api/v1/query"
  params = {"query": 'count(up{instance=~".*:9100"} == 1) + 100'}
  response = requests.get(url, params=params)
  print(response.json())
  

• Postman：直接在「Params」面板的「Value」栏输入完整查询语句，Postman会自动将+编码为%2B，无需手动修改。

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