Fiware IoT Agent配置带指令执行器时触发400 Bad Request错误

基础已完成配置 #

你已通过IoT Agent北向接口完成服务组创建，对应配置逻辑为：

import requests

url = 'http://localhost:4041/iot/services'
headers = {'Content-Type': "application/json", 'fiware-service': "openiot", 'fiware-servicepath': "/mtp"}

data = {
 "services": [
   {
     "apikey":      "456dgffdg56465dfg",
     "cbroker":     "http://orion:1026",
     "entity_type": "Door",
     #resource attribute is left blank since HTTP communication is not being used
     "resource":    ""
   }
 ]
}
res = requests.post(url, json=data, headers=headers)

if res.status_code == 201:
    print("Created")
elif res.status_code == 409:
    print("A resource cannot be created because it already exists")
else:
    print(res.raise_for_status())

异常复现现象 #

在配置带指令能力的执行器设备时，调用/iot/devices接口创建设备持续返回400 Bad Request；经测试，从请求体中移除commands字段后，设备可正常完成创建。
对应的设备配置请求代码为：

import requests

url = 'http://localhost:4041/iot/devices'
headers = {'Content-Type': "application/json", 'fiware-service': "openiot", 'fiware-servicepath': "/mtp"}

data = {
 "devices": [
    {
      "device_id": "door003",
      "entity_name": "urn:ngsi-ld:Door:door003",
      "entity_type": "Door",
      "protocol": "PDI-IoTA-UltraLight",
      "transport": "MQTT",
      "commands": [
        {"name": "unlock","type": "command"},
        {"name": "open","type": "command"},
        {"name": "close","type": "command"},
        {"name": "lock","type": "command"}
       ],
       "attributes": [
        {"object_id": "s", "name": "state", "type":"Text"}
       ]
    }
  ]
}

res = requests.post(url, json=data, headers=headers)

if res.status_code == 201:
    print("Created")
elif res.status_code == 409:
    print("Entity cannot be created because it already exists")
else:
    print(res.raise_for_status())

关联错误日志 #

IoT Agent侧记录的核心错误信息为：

iot-agent | time=2021-02-17T11:39:44.132Z | lvl=DEBUG | corr=16f27639-49c2-4419-a926-2433805dbdb3 | trans=16f27639-49c2-4419-a926-2433805dbdb3 | op=IoTAgentNGSI.GenericMiddlewares | from=n/a | srv=smartdoor | subsrv=/mtp | msg=Error [BAD_REQUEST] handling request: Request error connecting to the Context Broker: 501 | comp=IoTAgent
iot-agent | time=2021-02-17T11:39:44.133Z | lvl=DEBUG | corr=390f5530-f537-4efa-980a-890a44153811 | trans=390f5530-f537-4efa-980a-890a44153811 | op=IoTAgentNGSI.DomainControl | from=n/a | srv=smartdoor | subsrv=/mtp | msg=response-time: 29 | comp=IoTAgent

核心根因定位 #

1. 协议能力不匹配是触发错误的根本原因
   • 你部署的Orion Context Broker 2.2.0 是经典NGSI v2版本实现，完全不具备NGSI-LD协议的接口处理能力，收到NGSI-LD格式的请求时会直接返回501 Not Implemented状态码。
   • 你使用的IoT Agent UL版本（1.15.0-next）已经内置NGSI-LD格式自动识别逻辑：当检测到配置的entity_name为urn:ngsi-ld:开头的URN格式时，即使环境变量明确配置了IOTA_CB_NGSI_VERSION=v2，在执行带command的设备注册流程（需要向Orion注册Context Provider路由信息、配置属性更新通知订阅）时，会自动切换为调用NGSI-LD格式的接口，直接触发Orion返回501错误。
   • 移除commands字段后可以正常创建设备的原因：此时IoT Agent仅需要执行普通的实体属性同步操作，全程走NGSI v2兼容接口，不会触发NGSI-LD的调用逻辑，因此请求可以正常完成。
2. 日志信息的佐证
   错误日志已经明确标注IoT Agent在请求Orion时收到了501状态码，这个状态码代表Orion无法识别当前请求的接口格式，和设备配置中的commands字段本身的语法正确性无关。

可落地修复方案 #

• 调整实体命名格式：将entity_name从urn:ngsi-ld:Door:door003修改为NGSI v2格式的普通字符串（比如door003、Door:door003），消除IoT Agent的NGSI-LD自动识别逻辑，全程走NGSI v2协议完成和Orion的通信。
• 替换组件版本匹配协议能力：如果需要保留NGSI-LD格式的实体ID，将当前的经典Orion Context Broker替换为支持NGSI-LD协议的Orion-LD组件，匹配IoT Agent的协议调用逻辑。
• 排查租户配置一致性：日志中出现的srv=smartdoor和请求头中携带的fiware-service: openiot不一致的问题，需要检查是否存在环境变量默认值覆盖自定义请求头的情况，避免租户路由不匹配的附加问题。

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