Android Studio开发类WhatsApp应用：如何基于Firebase实现仅联系人可见头像？

一、调整Firebase实时数据库结构 #

Firebase的Map结构刚好适合高效判断「是否存在」的场景，不用存列表，而是给每个用户节点添加contacts子节点，将联系人的UID作为键，值设为true（或联系人昵称等轻量信息）。示例结构如下：

users
  |- {用户A的UID}
      |- profile
          |- name: "张三"
          |- avatar: "https://xxx/avatar1.jpg"
          |- ...
      |- contacts
          |- {用户B的UID}: true
          |- {用户C的UID}: true
  |- {用户B的UID}
      |- profile
          |- name: "李四"
          |- avatar: "https://xxx/avatar2.jpg"
          |- ...
      |- contacts
          |- {用户A的UID}: true

这种结构下，判断「用户A是否在用户B的联系人列表」只需查询/users/{B的UID}/contacts/{A的UID}是否存在，查询效率是O(1)，远优于遍历列表。

二、本地通讯录与Firebase联系人同步 #

要实现联系人匹配，核心是把本地通讯录里已注册应用的用户同步到Firebase的contacts节点：

1. 手机号映射节点：新增phoneToUID节点，存储「注册手机号 → 用户UID」的映射，方便通过本地手机号快速找到对应平台用户（注意设置安全规则，仅允许认证用户/云函数查询，避免手机号泄露）：

   phoneToUID
     |- "+8613xxxxxxxxx": "{用户A的UID}"
     |- "+8613xxxxxxxxx": "{用户B的UID}"
   

2. 同步逻辑：
   • 打开应用时，获取本地通讯录的手机号列表；
   • 批量查询phoneToUID节点，得到已注册用户的UID集合；
   • 将这些UID同步到当前用户的contacts节点：新增的UID设为true，移除本地通讯录中已删除的用户对应的键。

三、控制头像访问权限（两种方案） #

方案1：用Firebase安全规则直接控制

通过安全规则限制，只有目标用户的联系人才能读取其头像字段，无需额外代码：

{
  "rules": {
    "users": {
      "$uid": {
        "profile": {
          "avatar": {
            // 仅当请求者是$uid的联系人时，允许读取头像
            ".read": "root.child('users').child($uid).child('contacts').child(auth.uid).exists()"
          }
        },
        "contacts": {
          // 仅用户自己能查看自己的联系人列表
          ".read": "auth.uid === $uid"
        }
      }
    }
  }
}

客户端请求目标用户头像时，若当前用户是对方联系人，就能拿到真实头像URL；否则读取失败，客户端显示默认头像即可。

方案2：通过云函数处理（更安全）

如果不想暴露联系人列表的结构，可通过云函数封装逻辑，客户端仅传入目标UID和当前UID，由云函数判断并返回头像：

exports.getAvatar = functions.https.onCall(async (data, context) => {
  const targetUID = data.targetUID;
  const currentUID = context.auth.uid;

  if (!targetUID || !currentUID) {
    throw new functions.https.HttpsError('invalid-argument', '缺少必要参数');
  }

  // 查询目标用户的联系人是否包含当前用户
  const contactSnapshot = await admin.database()
    .ref(`/users/${targetUID}/contacts/${currentUID}`)
    .once('value');
  
  if (contactSnapshot.exists()) {
    // 存在，返回真实头像
    const avatarSnapshot = await admin.database()
      .ref(`/users/${targetUID}/profile/avatar`)
      .once('value');
    return avatarSnapshot.val() || 'https://xxx/default-avatar.jpg';
  } else {
    // 不存在，返回默认头像
    return 'https://xxx/default-avatar.jpg';
  }
});

客户端调用该云函数即可获取对应头像，全程不会暴露目标用户的联系人列表。

内容的提问来源于stack exchange，提问作者Jaffar