CosmosDB的CONTAINS函数传入bool可选参数时查询失效问题咨询

这个查询异常基本是以下几个问题导致的，按出现概率从高到低排：

• 参数名大小写不匹配：Cosmos DB SQL API对参数名的匹配是严格大小写敏感的。你描述里提到的参数是@ignoreTest（中间的t大写），但SQL语句里写的是全小写的@ignoretest，只要两边参数名有一个字符大小写对不上，SDK就无法识别参数，直接抛出查询错误。
• 漏传其他必填参数：你贴的C#代码只添加了@ignoretest一个参数，SQL语句里用到的@type、@search两个参数如果没有同步加入参数集合，查询会直接报错。
• 旧版SDK序列化bug：如果确认参数名完全一致、参数也都传全了还是报错，检查你用的.NET SDK版本，3.12.0之前的版本存在布尔类型参数序列化异常的问题，会把C#的布尔true转成字符串类型传入，导致CONTAINS函数参数类型不匹配。要么升级SDK到最新稳定版，要么暂时把CONTAINS的第三个参数直接写为字面量true/false，不走参数化。
• 附带的逻辑bug：你查询里c.deleted = null的写法本身是错的，Cosmos DB SQL中任意值和null做等于比较都会返回undefined，最终会被判定为false，根本起不到判断字段为null的作用，正确写法是用内置的IS_NULL()函数。这个问题和CONTAINS参数无关，但哪怕修好前面的问题，这句也会导致查询结果不符合预期。

SQL查询 #

SELECT * FROM c 
WHERE c.__type = @type 
AND CONTAINS(c.title, @search, @ignoreCase)
AND (NOT IS_DEFINED(c.archived) OR c.archived = false) 
AND (NOT IS_DEFINED(c.deleted) OR IS_NULL(c.deleted))

C#参数定义 #

var sqlParams = new SqlParameterCollection();
// 注意：参数名大小写必须和SQL语句里的写法完全一致
sqlParams.Add(new SqlParameter { Name = "@type", Value = "对应业务类型值" });
sqlParams.Add(new SqlParameter { Name = "@search", Value = "搜索关键词" });
sqlParams.Add(new SqlParameter { Name = "@ignoreCase", Value = true });

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