FIWARE IoT Agent-JSON配置执行器报400错误，Orion返回201

环境配置 #

FIWARE Orion-LD Context Broker (v3.10.0)
IoT Agent-JSON (v1.29.0)
使用NGSI-v2 API交互

复现步骤 #

向IoT Agent发送设备配置请求：

POST /iot/devices
{
  "devices": [
    {
      "device_id": "act012",
      "entity_name": "urn:ngsi-ld:act:012",
      "entity_type": "test",
      "transport": "HTTP",
      "endpoint": "http://iot-sensors:3001/iot/lamp001",
      "commands": [
        {"name": "on","type": "command"},
        {"name": "off","type": "command"}
      ],
      "attributes": [
        {"object_id": "s", "name": "state", "type":"Text"},
        {"object_id": "l", "name": "luminosity", "type":"Integer"}
      ],
      "static_attributes": [
        {"name":"refStore", "type": "Relationship","value": "urn:ngsi-ld:Store:001"}
      ]
    }
  ]
}

错误响应 #

400 Bad Request
{
    "name": "BAD_REQUEST",
    "message": "Request error connecting to the Context Broker: 201"
}

IoT Agent注册请求日志 #

IoT Agent尝试向Context Broker创建注册的请求内容：

POST http://orion-proxy:1027/v2/registrations
{
    "dataProvided": {
        "entities": [{"type": "test", "id": "urn:ngsi-ld:act:012"}],
        "attrs": ["on", "off"]
    },
    "provider": {
        "http": {"url": "http://iot-agent:4041"}
    }
}
Headers: {
    "fiware-service": "openiot",
    "fiware-servicepath": "/",
    "Authorization": "Bearer ..."
}

已尝试的排查操作 #

• 验证Orion可正常访问，直接发送注册请求返回201
• 确认设备端点可访问
• 测试NGSI-v2和NGSI-LD两种实体ID格式
• 简化静态属性（移除Relationship类型）

关键观察点 #

• Orion返回HTTP 201（Created）作为注册响应，但IoT Agent将其判定为错误
• 静态属性使用"type": "Relationship"，NGSI-v2中是否应使用"Reference"？
• 注册请求中的实体ID使用了NGSI-LD前缀，但交互用的是NGSI-v2 API

核心疑问 #

为何Orion返回201状态码，IoT Agent-JSON仍报BAD_REQUEST错误？命令定义、注册负载或类型声明是否存在问题？

1. 核心原因：IoT Agent对Orion-LD返回码的兼容性差异 #

IoT Agent-JSON v1.29.0是针对标准NGSI-v2 Broker开发的，标准NGSI-v2规范中创建注册的成功响应是204 No Content；而Orion-LD作为LD兼容的Broker，在处理v2注册请求时遵循LD规范返回201 Created。IoT Agent默认只把204当成注册成功的标志，因此将201判定为错误。

2. 次要因素：NGSI版本格式不统一 #

• 实体ID格式：虽然Orion-LD兼容NGSI-LD格式的ID，但在v2 API模式下使用urn:ngsi-ld:前缀可能引发不必要的兼容问题
• 命令属性类型：NGSI-v2规范中命令属性的类型应为Command（首字母大写），而非小写的command，尽管Orion-LD可能接受小写格式，但IoT Agent后续处理可能出现异常

解决方案 #

（1）调整IoT Agent配置，兼容201状态码

修改IoT Agent的环境变量或配置文件，添加以下配置：

CB_REGISTRATION_SUCCESS_CODES=201,204

该配置会让IoT Agent将201和204都视为注册成功的有效响应。

（2）统一NGSI-v2格式规范

• 将命令属性的type改为大写的Command：

  "commands": [
    {"name": "on","type": "Command"},
    {"name": "off","type": "Command"}
  ]
  

• 改用NGSI-v2格式的实体ID，例如将urn:ngsi-ld:act:012改为urn:ngsi-v2:act:012

（3）验证静态属性类型（可选）

NGSI-v2中关系类型确实是Relationship，而非Reference，但如果怀疑该字段引发问题，可暂时改为Text类型测试，确认是否为影响因素。

验证步骤 #

1. 重启IoT Agent应用新配置
2. 按修改后的格式重新发送设备配置请求
3. 检查IoT Agent日志，确认注册请求被正常处理

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