枚举日志检索索引

验证状态:已源码核验、未联调(中心代理段已闭合;Meilisearch 服务器本体不在本工作区);适用基线:源码归纳 @ 2026-09-14

用途与场景

列出检索引擎中的全部索引 uid,用于把按日期分区的候选索引名过滤为真实存在的索引。当前 Web 日志/报表类页面在首次检索时调用(每会话缓存一次结果)。

使用位置

页面/功能 角色或空间分支
分区日志搜索(用户日志/GPS/电量等) 登录用户;请求携带登录 token
MQTT 连接统计(admin) 同上
MQTT 连接统计(to-b) 同上

端点

GET /main-service/system-api/meilisearch/indexes?limit={limit}(SDK 经中心代理访问检索引擎)— 列出检索引擎中的全部索引 uid(Web 传大 limit 取全集)。

代理契约:MeilisearchProxyController 透传 /system-api/meilisearch/** 全部方法(登录 token 被代理剥除并以服务端 api-key 重写,响应不走中心 {status,data} 信封);该代理不在 Swagger 分组,属清单层已知缺口项(allowlist 登记)。分区索引的写侧调度见设备业务 · runtime-links 运行时关联

动线与完成判据

SDK Promise resolve 且 results[].uid 可过滤即完成;Web 对失败走 to + log.error,页面呈现空结果。

错误与边界

上游错误经代理转 ApiException("Meilisearch proxy error: …") 并保留上游 HTTP 状态;与中心业务信封不同,检索引擎响应不走 {status,data} 信封。代理错误差异另见错误响应差异。读取无副作用,可重试。

调用关系与资源清理

无长连接资源。Web 每会话首搜调用一次并缓存 uid 列表(existingIndexUidsRef),后续搜索复用;随后才触发设置初始化(见更新索引设置)。

已知缺口

Meilisearch 服务器本体不在本工作区:响应字段全集、分页语义、错误码全集以官方 API 为准,本页只记录 Web 实际消费键与中心代理段合同;目标环境 api-key/索引命名一致性未联调核验。