SuperAPI AI 工具集

cometchat-angular-v5-troubleshooting

编程与开发

查看项目

更新于 10-21 20:28

技能介绍

用途

本技能面向 CometChat Angular v5 集成出现故障时的排查与修复。适用场景包括:错误信息缺失或无用、界面空白、列表为空、事件不触发、UI 不随数据更新、内存持续增长等。技能基于已安装的 @cometchat/chat-uikit-angular@5(5.1.0–5.2.0 已验证)以及官方 troubleshooting 文档页面进行验证。

主要能力

技能指出,CometChat-Angular 最常见的五类故障中有四类完全不产生错误。因此它提供四项优先检查:

  1. 组件是否在 imports: [] 中——缺失时 Angular 会把 <cometchat-conversations> 当作未知 HTML,静默渲染空白。
  2. 容器是否有高度——需要 html, body { height: 100%; margin: 0; }、100dvh 外壳,以及每个 flex 列上的 min-height: 0。
  3. login() 是否在渲染前 resolve——无会话时列表为空且无报错,需检查 CometChatUIKit.getLoggedInUser() 非空。
  4. 绑定名是否真实——例如 (ccConversationClicked) 永不触发,真实输出是 (itemClick),Angular 不会对未知输出发出警告。

技能还提供症状→原因→修复对照表,涵盖:图标缺失(angular.json 未注册 assets)、滚动穿透整页(缺少 overflow: hidden)、列表无法滚动(标签自身缺少 flex: 1; min-height: 0)、错误边界尺寸问题(cometchat-error-boundary 按元素而非类样式)、通话日志显示错误(5.1.0 的 KIT BUG,CallLogsService 未等待懒加载 calls-SDK)、空白面板、列表始终为空、点击处理不触发、选中行不高亮、消息到达但 UI 不更新(Angular 21 默认无 zone,需写 signal 或 markForCheck)、路由切换内存增长(需 takeUntil + removeMessageListener)、消息重复、并发登录报错、npm install ERESOLVE(Angular 22 超出 peer 范围 <22.0.0)、样式路径未导出、运行时配置为空(Angular 读 environment.ts 而非 .env)、导入无法编译、头部与消息区主体不一致、回复按钮无效、功能缺失(仪表盘扩展未开启)、通话按钮零尺寸(initFromSettings 缺少 uiKit.callsSDK)、首次加载报错且重试无效、通话不响铃、局域网 IP 通话失败(需 HTTPS 或 localhost)、SSR window is not defined、下拉被裁剪、数据加载时布局跳动等。

使用方式

按四项静默失败检查顺序执行;再查对照表定位症状。若表中未覆盖,可确认符号是否为真实导出类名、获取组件文档页比对每个输入、检查浏览器控制台的 CometChat 错误码、提高日志级别 CometChatUIKit.setLogLevel(...)、回退到核心技能中的黄金路径以判断问题在组合还是配置。修复完成后需验证:聊天渲染真实数据、点击会话可打开、发送消息立即出现、第二个浏览器实时收到、无控制台错误、无元素塌陷为零高度。

适用场景

适用于使用 CometChat Angular v5 UI Kit 的 Angular 项目在集成、渲染、事件、样式、通话、SSR 等环节出现异常时的诊断。

限制

技能明确警告:不要用 --force 或 --legacy-peer-deps 绕过 ERESOLVE;不要用 !important 对抗 kit 样式;不要因为某个交互看起来坏了就手写重建组件。技能还指出与官方文档的一处分歧:文档称支持 Angular 22,但 peer 范围排除它且 npm install 会硬失败,应以已安装包为准。@cometchat/cards-angular 自 5.1.0 起为必需依赖。