Postman中Cosmos Query Where子句使用异常问题排查

核心结论：斜杠本身不需要转义，问题大概率出在查询语法或匹配逻辑上 #

以下是具体排查和解决步骤：

• 确认查询函数的正确用法
  如果要判断RequestPath包含指定路径，必须使用CONTAINS函数，不能用自然语言式的伪语法。正确的查询语句示例：

  SELECT * FROM f WHERE CONTAINS(f.RequestPath, "/payments/post-sales")
  

  如果是精确匹配完整路径，直接用等于判断即可：

  SELECT * FROM f WHERE f.RequestPath = "/payments/post-sales"
  

• 检查字段名与大小写一致性
  Cosmos DB对字段名和字符串值大小写敏感：

  • 确认文档中的字段确实是RequestPath（而非requestPath等大小写变体）
  • 确保查询中的路径字符串与文档存储的内容完全一致，比如文档里是/Payments/Post-Sales，小写查询就会匹配失败

• 排查Postman参数传递问题
  若使用Postman环境变量存储路径值，需确认变量未被自动转义（比如斜杠被转成%2F），直接传递原始字符串即可。

• 验证查询逻辑
  先在Cosmos DB门户的查询编辑器中测试语句，确认能返回结果后再复制到Postman执行，排除Postman请求配置的问题。

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