PouchDB同步Couchbase Scope与Collection报错：数据库不存在

你遇到的问题是因为PouchDB不识别mydb._default.myCollection这种点分隔的命名格式——该格式是PouchDB本地数据库的命名规则，无法直接映射到Sync Gateway的Scope和Collection结构。下面是两种可行的解决方法：

方法1：直接通过URL路径指定Scope和Collection #

直接在PouchDB的连接URL中明确指定Scope和Collection的路径，替换原来的点分隔格式：

// 正确的连接方式
const db = new PouchDB("http://localhost:4984/mydb/_default/myCollection");

这个路径和你用REST API访问的格式完全一致，Sync Gateway会正确识别并路由到_default Scope下的myCollection集合。

方法2：在Sync Gateway配置中添加Collection别名 #

如果不想在客户端URL中写冗长的路径，可以在Sync Gateway的配置文件中，为目标Collection创建一个独立的数据库别名，客户端直接用别名连接即可：

修改Sync Gateway的配置文件（通常为sync-gateway-config.json），添加一个新的数据库条目：

{
  "databases": {
    // 原有的默认数据库配置
    "mydb": {
      "server": "couchbase://localhost",
      "bucket": "mydb",
      "scope": "_default",
      "collection": "_default",
      "users": {
        "GUEST": {
          "disabled": false,
          "admin_channels": ["*"]
        }
      }
    },
    // 新增的Collection别名配置
    "mydb_mycollection": {
      "server": "couchbase://localhost",
      "bucket": "mydb",
      "scope": "_default",
      "collection": "myCollection",
      "users": {
        "GUEST": {
          "disabled": false,
          "admin_channels": ["*"]
        }
      }
    }
  }
}

重启Sync Gateway后，客户端可以用别名直接连接：

const db = new PouchDB("http://localhost:4984/mydb_mycollection");

注意事项 #

• 确保你的Sync Gateway版本在2.8及以上，该版本开始正式支持Scope和Collection特性
• 检查Sync Gateway配置中指定的Scope和Collection，确实存在于对应的Couchbase Bucket中
• 验证客户端的访问权限，确保配置的用户（比如GUEST）拥有对应Collection的读写权限

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