搜索消息

searchLocalMessages() 搜索当前用户本地已同步消息。群聊目标使用对应的 conversationID，不是发送时使用的 groupID。跨用户审计或服务端全量搜索应由后端服务提供。

如果入口只有用户 ID 或群组 ID，先调用 getConversationIDBySessionType(sourceID:, sessionType:) 换取会话 ID；单聊使用 ConversationType.single，群聊按实际会话类型使用对应值。全局搜索则省略 conversationID。

搜索范围来自 SDK 已同步到当前设备本地缓存的消息。需要跨用户审计、服务端全量检索、复杂权限过滤或全局排序时，应由后端搜索服务承担，再把命中的会话和消息标识返回客户端定位。

创建搜索查询

keywordList 接收关键词列表，但固定 Flutter 实现当前只使用一个关键词。搜索框提交前应去掉首尾空格并过滤空值，避免把空关键词传给 SDK。

final keyword = input.trim();
if (keyword.isNotEmpty) {
  final result = await OpenIM.iMManager.messageManager.searchLocalMessages(
    conversationID: conversationID,
    keywordList: [keyword],
    messageTypeList: [MessageType.text, MessageType.atText],
    pageIndex: 1,
    count: 20,
  );
  renderSearchResult(result);
}

高级搜索

searchLocalMessages() 还公开发送者、消息类型和时间窗口等筛选字段。固定 Flutter 实现目前未使用 keywordListMatchType 和 senderUserIDList，因此不能把它们描述为已经生效的过滤能力；需要可靠的发送者筛选时，应在当前 SDK 版本验证行为或由后端搜索服务处理。

final result = await OpenIM.iMManager.messageManager.searchLocalMessages(
  conversationID: conversationID,
  keywordList: ['release'],
  messageTypeList: [MessageType.text],
  searchTimePosition: searchTimePosition,
  searchTimePeriod: searchTimePeriod,
  pageIndex: 1,
  count: 20,
);

如果搜索入口允许搜索图片、文件或自定义消息，把对应的 MessageType 数字常量加入 messageTypeList。不需要限制消息类型时，按固定 SDK 的默认行为构造参数，不要自行假设所有内容类型都会参与关键词匹配。

参数说明

处理分页结果

返回 SearchResult，其字段在固定 SDK 中均为 nullable：

每个 SearchResultItems 对应一个会话：

继续分页时保持关键词、发送者、类型和时间条件不变，只增加 pageIndex；修改任一条件时重置为第 1 页并清空旧结果。同一搜索页按结果项的 conversationID 与消息的 nullable clientMsgID 去重，不能按结果位置保存选中项。

getConversationIDBySessionType() 与 searchLocalMessages() 的 Future 成功后，直接使用返回值建立会话 ID 和搜索结果快照。两个查询都不会触发消息事件。

处理搜索结果变化

搜索命中的消息可能在页面打开后被撤回、删除，或由新的同步数据补充。应使用接收消息、删除消息和撤回消息中的统一处理器更新结果；本页只负责搜索与分页，不重复设置消息 listener。

跳转到命中消息时，使用结果项的 conversationID 和消息的 clientMsgID 定位。需要展示前后文时，按按 ID 定位消息分别读取较旧与较新的消息；固定 Flutter SDK 没有 WASM 的 fetchSurroundingMessages()，不能直接照搬该调用。

需要显示当前时刻的搜索结果时，可以用相同条件重新执行查询。搜索 Future、消息事件增量和重新查询校准是三条独立路径。

相关页面

• 按 ID 定位消息
• 加载历史消息
• 接收消息