Couchbase条件同步实现：仅同步用户相关数据至移动端

问题描述 #

我正在开发一款聊天应用，移动端用户的数据存储在本地设备中。我们希望仅将服务器（Couchbase Server）中与用户相关的数据同步至客户端（Couchbase Mobile），但目前使用Swift开发的移动端会将服务器端整个Bucket的数据同步至本地数据库。我的同步配置JSON如下：

{ 
  "interface": "192.168.0.68:4984", 
  "adminInterface": "192.168.0.68:4985", 
  "pretty": true, 
  "log": ["*"], 
  "databases": { 
    "db": { 
      "server": "http://192.168.0.68:8091", 
      "bucket": "travel-sample", 
      "username":"himanshu", 
      "password":"123456", 
      "users": { 
        "himanshu": { 
          "password": "123456", 
          "admin_channels": [ "*" ] 
        } 
      }, 
      "sync": `function (doc) { 
        console.log("doc=================================================================>") 
        channel (doc.channels); 
      }` 
    } 
  } 
}

请问是否可以实现服务器仅向移动端同步用户相关数据的需求？

当然可以实现！你只需要调整Sync Gateway的用户权限配置和同步函数逻辑两个核心部分，就能精准控制同步到移动端的数据范围： #

1. 移除用户的全局访问权限

当前你的用户himanshu被设置了admin_channels: ["*"]，这相当于给了这个用户“超级权限”——能访问所有通道里的所有文档，自然会同步整个Bucket的数据。你需要把这个配置改成仅授予用户其专属的通道权限，比如：

"users": {
  "himanshu": {
    "password": "123456",
    "channels": ["user-himanshu", "public-chats"] // 只给用户自己的专属通道+必要的公共通道权限
  }
}

如果你的用户数量较多，不想手动配置每个用户的通道，也可以后续在同步函数中用动态逻辑分配权限，不过静态配置适合初期测试和简单场景。

2. 修改同步函数，把文档分配到对应通道

你的现有同步函数只是直接复用文档里的channels字段，但如果文档没有正确标记归属，或者用户权限太宽，就会同步全部数据。你需要让同步函数根据文档的归属，把它分配到对应的用户专属通道，比如假设你的聊天文档里有owner字段存储所属用户ID：

function (doc) {
  // 先过滤掉不需要同步的文档（比如系统配置类数据）
  if (doc.type !== "chat_message" && doc.type !== "user_profile") {
    return;
  }

  // 给用户专属文档分配到个人通道
  if (doc.owner) {
    const userChannel = `user-${doc.owner}`;
    channel(userChannel);
  }

  // 如果是聊天消息，还要分配给接收方的通道（聊天应用必备逻辑）
  if (doc.type === "chat_message" && doc.recipient) {
    const recipientChannel = `user-${doc.recipient}`;
    channel(recipientChannel);
  }

  // 公共聊天内容分配到公共通道
  if (doc.type === "public_chat") {
    channel("public-chats");
  }
}

这样一来，只有被分配到用户有权限访问的通道里的文档，才会被同步到该用户的移动端本地数据库。

3. 额外验证小技巧

• 你已经开启了log: ["*"]，可以查看Sync Gateway的日志，检查每个文档的通道分配是否符合预期；
• 确保服务器端的所有用户相关文档都正确设置了owner、recipient这类标识归属的字段，不然同步函数无法正确分配通道；
• 测试时可以在移动端用用户himanshu登录，然后查看本地数据库，确认只有他的个人数据和公共聊天数据被同步过来。

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