用途：系统化诊断并修复 CometChat Android 集成中的问题，涵盖 Gradle 构建错误、运行时崩溃、渲染问题与版本兼容性。配套技能：cometchat-android-v5-core 负责正确的初始化/登录模式，cometchat-android-v5-production 负责 ProGuard 规则。
适用场景：出现“CometChat 不工作”“构建报错”“聊天界面空白”“消息不加载”、Gradle 同步失败、堆栈中含 CometChat 的运行时崩溃时使用。不适用于新建集成（用 core）与自定义外观（用 theming）。
常见问题与修复：无法解析 com.cometchat:chat-uikit-android 时，在 repositories 添加 maven { url "https://dl.cloudsmith.io/public/cometchat/cometchat/maven/" }；出现重复类 com.cometchat.* 说明存在多个版本，用 ./gradlew app:dependencies 检查依赖树；会话列表空白通常是未登录或无会话，确认 getLoggedInUser() != null；ERR - Authentication null 说明 init() 未调用或失败，需先 init() 后 login()，检查 isSDKInitialized()；appIdErr 需在 UIKitSettingsBuilder 中 setAppId()；组件显示但无数据通常是区域不匹配，需与后台一致（"us"、"eu"、"in"）；release 构建 ClassNotFoundException 由 ProGuard 剥离类导致，需在 proguard-rules.pro 添加 -keep class com.cometchat.** { ; }；inflating 视图时 UnsupportedOperationException 由应用主题继承 Theme.AppCompat. 或 Theme.Material3.* 导致，需将应用主题父级改为 CometChatTheme.DayNight；NetworkOnMainThreadException 说明在主线程调用同步方法，应使用回调（所有方法均为异步）；minSdkVersion 21 报错需在 build.gradle 设为 24；消息列表显示错误消息需核对 setUser()/setGroup() 的 UID/GUID；通话按钮不显示需添加 com.cometchat:calls-sdk-android:4.+ 依赖；NoSuchMethodError 是 UI Kit 与 Chat SDK 版本不匹配，UI Kit 5.x 需搭配 Chat SDK 4.x。
诊断步骤：检查 init（isSDKInitialized() 必须为 true）；检查登录（getLoggedInUser() 不可为 null）；用 ./gradlew app:dependencies | grep cometchat 核对版本；检查 manifest 的 INTERNET 权限；区域必须与后台完全一致；在 logcat 过滤 CometChat 标签。
硬性规则：始终先查 init 与 login，多数“不工作”问题源于此；不要猜测原因，查看 logcat、依赖树与后台；ProGuard 是 release 构建的首要问题，首次发布构建前先加 keep 规则。
限制：资料未提供具体价格、支持平台范围与更多未列出的错误码说明。