GetStream QueryUsers API报错缺失请求负载，求指导添加方法

算力阿峰

2026-5-9

解决QueryUsers API "Missing request payload" 错误

我之前也碰到过这个反常规的情况——虽然Stream的QueryUsers是GET请求，但它必须携带JSON格式的请求体来传递查询条件，这是Stream API的特殊设计，不是你操作错了。下面是具体的解决步骤：

1. 设置正确的请求头

首先要确保请求头里包含Content-Type: application/json，让服务器知道你发送的是JSON格式的负载。

2. 构造查询负载

你需要把查询条件、排序规则、分页参数等封装成JSON对象，示例如下：

{
  "filter_conditions": {
    // 按角色筛选示例
    "role": "user",
    // 按用户ID列表筛选示例
    "id": { "$in": ["user_123", "user_456"] }
  },
  "sort": [{"field": "created_at", "direction": -1}], // 按创建时间倒序
  "limit": 20, // 返回结果数量
  "offset": 0 // 分页偏移量
}

filter_conditions支持Stream的查询语法，你可以根据需求组合不同条件，比如匹配用户名、自定义字段等。

3. 发送请求（附示例）

虽然HTTP规范里GET请求通常不带body，但几乎所有主流HTTP客户端都支持这种做法，Stream的API也完全兼容。这里给个cURL的示例：

curl -X GET "https://your-cluster.stream-io-api.com/users?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_AUTH_TOKEN" \
  -d '{
    "filter_conditions": {
      "role": "user"
    }
  }'

如果你用的是Stream官方SDK（比如JS、Python、Java等），对应的queryUsers方法会自动帮你处理请求体的封装，直接传入参数对象即可，不用手动拼HTTP请求。