Merge pull request #1414 from HuangFeiPeng/patch-5

Update conversation_list.md

Author: haoxiuwen

docs/document/web/conversation_list.md

@@ -57,4 +57,17 @@ connection.getServerConversations({pageSize:50, cursor: ''}).then((res)=>{
 | `unReadCount` | 未读消息数。 |
 | `marks` | 会话标记。|
 
-- cursor: 下次查询数据的游标位置。若 SDK 返回的数据条数小于请求中设置的数目，`cursor` 的值为空字符串（''），表示当前为最后一页数据。否则，SDK 返回具体的游标位置，指定开始获取数据的位置。
+- cursor: 下次查询数据的游标位置。若 SDK 返回的数据条数小于请求中设置的数目，`cursor` 的值为空字符串（''），表示当前为最后一页数据。否则，SDK 返回具体的游标位置，指定开始获取数据的位置。
+
+---
+
+##  服务端获取会话列表接口限制与最佳实践
+:::tip
+| 限制点 | 说明 | 推荐做法 |
+|--------|------|----------|
+| **lastMessage 与未读数延迟或接口调用超过限制频次** | 服务端更新为 **异步** 行为，收到实时消息后 **立即调用本接口** 可能拿到 **过期数据**（旧 lastMessage、未读数未刷新）。 | ① **初始化会话列表** 首次登录后仅调用一次 getServerConversations，将返回结果写入全局状态管理或内存中；<br/> ②**会话更新** 收发消息通过回调返回的消息内容更新缓存中的最新一条消息数据以及未读数； |
+| **会话属性缺失** | 返回的会话对象 **不包含**「用户属性（头像、昵称等）」及「群组详情（群名称、群公告等）」。 | ① 展示会话列表时先渲染 **会话 ID** 与 **最后一条消息摘要**；<br/> ② 并行调用「用户属性/群组详情接口」补全属性，并本地缓存以避免重复请求。 |
+| **RESTful 消息默认不写入会话** | 通过 RESTful 发送的消息不会更新会话列表。 | 若需 RESTful 消息也能刷新会话，需在控制台开启 **「RESTful 消息写入会话列表」** 开关。
+
+
+:::