IoT Hub路由查询IN子句使用方法及查询失效问题求助

刚遇到过类似的问题，我来帮你捋清楚怎么解决：

一、IN子句的基础用法 #

在IoT Hub的路由查询里，IN子句用来判断目标字段的值是否在指定的集合里，语法上两种写法都支持：

• 圆括号形式：$body.Weather.Temperature IN (30, 50)
• 方括号形式：$body.Weather.Temperature IN ['30','50']
  不过这里有个关键前提——子句里的值类型必须和字段的实际类型完全匹配，这也是很多人踩坑的点。

二、你的查询失效的核心原因 #

你写的$body.Weather.Temperature in ['30','50']没生效，大概率是类型不匹配：

• 如果设备上报的Temperature是数字类型（比如JSON里是"Temperature": 30，没有引号），但你在IN子句里把值写成了字符串格式的'30'、'50'，数字和字符串是完全不同的类型，自然匹配不到。
• 反过来，如果Temperature是字符串类型（比如"Temperature": "30"），那用数字格式的30也会匹配失败。

三、针对性解决办法 #

根据你的实际数据类型调整查询语句就行：

1. 如果Temperature是数字类型，去掉值的引号：

   $body.Weather.Temperature IN [30, 50]
   

   或者用圆括号写法也可以：

   $body.Weather.Temperature IN (30, 50)
   

2. 如果Temperature是字符串类型，确保值的引号正确（单双引号都能用，只要统一就行）：

   $body.Weather.Temperature IN ['30','50']
   

四、额外排查小技巧 #

要是调整后还是不行，可以检查这几点：

• 确认字段路径拼写正确：IoT Hub的查询路径是区分大小写的，比如别把Weather写成weather
• 查看设备上报的原始消息，确认Temperature字段确实存在，格式和你预期的一致
• 用IoT Hub自带的测试路由查询功能，输入模拟的消息体验证查询是否能正常匹配

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