联系人不显示：通讯录匹配失败的五种原因
装好应用打开一看，通讯录里认识的人一个都没出现。别急，联系人匹配依赖「权限 + 网络 + 对方注册状态」三个条件，缺一个列表就是空的。
原因一：通讯录权限没开（最常见）
应用读取不到你手机里的联系人，匹配无从谈起：
iPhone： 系统设置 → 应用列表找到 BOTIM → 打开「通讯录」开关
Android： 应用信息 → 权限 → 通讯录设为「允许」
开启后回到应用下拉刷新联系人页，通常几分钟内匹配结果就会出来。完整权限说明见 麦克风相机通讯录权限在哪开。
原因二：网络不通
联系人匹配是把号码列表送到服务端比对，需要网络：
- 换 WiFi / 数据试一次
- 关掉 VPN 再刷新
- 飞行模式开关一次，强制网络重连
原因三：号码没存对
匹配基于手机号，存储格式会导致匹配失败：
- 检查号码是否带了正确的国家区号——跨国通讯录尤其常见，对方号码没加 +971 之类的区号就匹配不上
- 建议按国际格式重存常用联系人：区号 + 号码
原因四：对方还没注册
通讯录只显示已经注册的用户。对方没装、没注册，或用了别的号码注册，你这边都不会出现。验证方法：直接在应用内搜索对方的号码，搜不到 = 对方不在这个号上。
原因五：同步延迟或缓存卡住
权限、网络都对但还是不显示：
- 彻底重启应用（从后台划掉）
- 退出登录重新登录，强制重新同步
- 更新应用到最新版本
- 实在不行联系客服
不靠通讯录也能加到人
通讯录匹配只是加好友的路径之一：
- 号码搜索：知道对方手机号，直接在应用内搜索添加
- 对方加你：把你的号码发给对方，让他主动添加
- 群聊里加：共同的群里点对方头像申请加好友
联系人功能边界
- 匹配是双向选择的：双方互相存了号码才会在彼此列表里高亮出现
- 隐私设置里隐藏「上线时间」等不影响联系人匹配（见 上线时间可见性）
- 删除应用不会删除服务端的好友关系，重装后登录原账号好友自动回来
一句话总结
联系人列表空 = 先查权限，再查网络，最后确认对方真的注册了。三步下来 95% 的问题都能定位。