使用Elasticsearch .NET Client传递SQL查询参数返回400错误

核心问题 #

你遇到的问题本质是：Elasticsearch SQL的参数绑定在服务端API层面要求传入数组格式，但你使用的Elastic.Clients.Elasticsearch 8.1.3版本中，QueryRequest的Params属性被定义为IDictionary<string, object>，这种字典结构序列化后是键值对JSON，和服务端期望的数组格式不兼容，所以触发x_content_parse_exception错误——哪怕传空字典也会因为结构不符报错，而Postman用数组参数符合服务端要求，所以能正常执行。

解决办法 #

绕过客户端自带的Params属性，直接手动构造包含数组参数的请求体：

方案1：使用Raw字段自定义请求内容 #

var sqlQuery = "SELECT * FROM my_index WHERE age > ? AND name = ?";
var request = new QueryRequest
{
    Query = sqlQuery,
    Raw = new Dictionary<string, object>
    {
        ["params"] = new object[] { 30, "Alice" }
    }
};

var response = await client.Sql.QueryAsync(request);

方案2：直接序列化匿名对象作为请求体 #

如果觉得Raw不够直观，也可以直接构建完整的请求对象并序列化：

var requestBody = new
{
    query = "SELECT * FROM my_index WHERE age > ? AND name = ?",
    @params = new object[] { 30, "Alice" }
};

var json = JsonSerializer.Serialize(requestBody);
var response = await client.Sql.QueryAsync(new StringRequest(json, "application/json"));

额外说明 #

1. 当前客户端版本（8.1.3）与服务端版本（8.7.1）存在跨版本差异，客户端的SQL参数绑定逻辑未同步服务端的格式要求，这也是官方文档未明确提及SQL命名空间相关细节的原因之一。
2. 后续可以考虑升级客户端版本到与服务端匹配的8.7.x版本，大概率会修复这个参数类型不兼容的问题。

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