OCB FIWARE服务查询limit参数异常：返回非匹配实体问询

问题现象 #

使用Postman向OCB FIWARE服务发送API查询，传入q=labels=='H_EO_R2001_01'筛选实体时出现异常：

• 匹配该查询的实体总数为23个
• 当limit ≤23时，返回对应数量的匹配实体，行为符合预期
• 当limit >23时，系统返回1000条实体（违反limit限制），包含全部23个匹配实体，以及大量无labels属性的不匹配实体

请求示例URL：

{{baseURL}}/v2/entities?options=keyValues&limit=25&q=labels=='H_EO_R2001_01'

正确返回实体示例：

{
    "type": "<HIDDEN>",
    "TimeInstant": "2025-11-27T09:44:32.460Z",
    [...]
    "labels": [
        "H_EO_R2001_01"
    ]
}

错误返回实体示例：

{
    "id": "<HIDDEN>",
    "type": "<HIDDEN>",
    "hmiAlarmTextSetpoint": ""
}

环境信息 #

• Orion版本：3.11.0
• MongoDB版本：mongoc 1.24.3
• /v2/registrations存在多个注册信息，但未被使用

预期行为 #

严格遵守limit参数限制，仅返回匹配查询条件的实体

可能的原因及解决方向 #

1. 版本bug
   Orion 3.11.0可能存在查询逻辑缺陷：当匹配结果数量不足limit值时，错误触发全量实体扫描且未正确过滤。建议升级到3.12.x及以上稳定版本，验证是否修复该问题。

2. 索引缺失
   若labels字段未创建索引，大量实体扫描场景下可能出现过滤器失效。在MongoDB中为实体集合的labels字段创建索引：

db.entities.createIndex({"attrs.labels.value": 1})

创建后重新测试查询。

3. 查询语法问题
   labels是数组类型，原精确匹配语法可能存在场景适配问题。尝试使用数组包含匹配语法：

{{baseURL}}/v2/entities?options=keyValues&limit=25&q=labels=@'H_EO_R2001_01'

4. 注册信息干扰
   临时移除/v2/registrations下的所有注册条目，验证是否是未使用的注册触发了第三方数据源的异常联动。

内容的提问来源于stack exchange，提问作者Jonas Schäfer