PouchDB与启用IAM/Legacy认证的Cloudant同步连接失败如何解决？

方案1：使用Legacy认证模式（和现有代码适配度最高） #

• 首先在Cloudant控制台生成Legacy专属凭证：进入Cloudant实例详情页→服务凭证→新建凭证，勾选「Include legacy credentials」选项，生成后提取username和password字段，注意这两个值不是IBM Cloud账号密码，是Cloudant实例专属的认证凭证。
• 修正现有代码的变量名错误、补全远程地址规则：远程地址末尾必须拼接要同步的目标数据库名，不能只填Cloudant根域名，修正后的代码如下：

var localDB = new PouchDB('todos');
// 替换为你的Cloudant实例域名+目标数据库名
const remoteUrl = "https://<Cloudant实例域名>/<目标数据库名>"
const remoteOptions = {
  auth: { 
    username: '<Legacy凭证中的username>', 
    password: '<Legacy凭证中的password>' 
  }
}  
const remoteDB = new PouchDB(remoteUrl, remoteOptions);

localDB.sync(remoteDB).on('complete', function () {
  // 同步完成
}).on('error', function (err) {
  console.error('同步错误', err)
});

• 配置数据库权限：进入Cloudant控制台→数据库→选中要同步的目标库→权限→添加用户，填入Legacy凭证的username，勾选_reader、_writer、_replicator三个权限。

方案2：使用IAM认证模式（安全性更高） #

IAM认证无法直接使用PouchDB默认的auth参数传值，需要手动在请求头携带IAM令牌：

• 先调用IBM Cloud IAM接口获取有效期1小时的访问令牌，再将令牌写入PouchDB的ajax请求头，代码示例如下：

var localDB = new PouchDB('todos');
// 替换为你的Cloudant实例域名+目标数据库名
const remoteUrl = "https://<Cloudant实例域名>/<目标数据库名>"
// 替换为你获取到的IAM访问令牌
const iamToken = '<IAM访问令牌>'
const remoteOptions = {
  ajax: {
    headers: {
      'Authorization': `Bearer ${iamToken}`
    }
  }
}  
const remoteDB = new PouchDB(remoteUrl, remoteOptions);

localDB.sync(remoteDB).on('complete', function () {
  // 同步完成
}).on('error', function (err) {
  console.error('同步错误', err)
});

• 使用该模式需要提前给对应IAM服务ID分配Cloudant实例的读写权限，以及目标数据库的操作权限，无需开启Legacy认证即可使用。

通用排错点 #

• 确认Cloudant控制台的CORS设置已放开你前端部署的域名访问权限，测试阶段可临时开启允许所有域名，避免跨域拦截导致同步失败。
• 同步报错时优先打印完整的err对象，根据状态码排查：401对应认证凭证错误，403对应权限不足，404对应目标数据库不存在。

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