非Docker部署UltraLight版Fiware IoT Agent 带命令的执行器注册报错

环境基础状态 #

• 部署形式：非Docker容器化直接运行的UltraLight协议IoT Agent
• 已验证正常能力：支持基础设备注册，可完成设备与Orion Context Broker的映射关联
• 异常触发点：当设备注册配置中携带commands属性（对应执行器/Actuator）时，注册流程失败

复现步骤 #

调用设备provisioning接口提交如下请求：

curl -iX POST \
  'http://MYIP:4061/iot/devices' \
  -H 'Content-Type: application/json' \
  -H 'fiware-service: openiot' \
  -H 'fiware-servicepath: /' \
  -d '{
  "devices": [
    {
      "device_id": "lamp003",
      "entity_name": "urn:ngsi-ld:Lamp:003",
      "entity_type": "Lamp",
      "protocol": "PDI-IoTA-UltraLight",
      "transport": "MQTT",
      "commands": [
        {"name": "on","type": "command"},
        {"name": "off","type": "command"}
       ]}
  ]
}'

错误返回内容 #

op=IoTAgentNGSI.DeviceProvisioning | from=n/a | srv=n/a | subsrv=n/a |
msg=Device provisioning failed due to the following error:  |
comp=IoTAgent Request error connecting to the Context Broker:
{"code":"400","reasonPhrase":"Bad Request","details":"missing isDomain value for registration attribute"}

已尝试的排查操作 #

• 在commands数组的每个命令项中显式添加"isDomain": "false"配置，异常无改善
• 回溯历史运行环境，确认同类注册配置此前可正常生效，Fiware官方文档提供了同类功能的配置参考

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