CouchDB身份验证时出现CORS问题，预检请求未通过访问控制检查

该报错由两个核心原因触发：

• 前端运行在http://localhost:8080，CouchDB服务运行在http://localhost:5984，二者属于不同源，CouchDB默认关闭跨域访问权限，OPTIONS预检请求直接被拦截
• 你自定义添加的X-Auth-CouchDB-Roles不属于CORS安全头范围，会强制触发预检请求，而CouchDB默认没有配置对该自定义头和OPTIONS请求的放行规则，同时你的PouchDB连接地址未补全HTTP协议前缀，会导致请求路径识别异常

步骤1：修正PouchDB连接地址 #

补全地址的HTTP协议前缀，避免PouchDB将远程服务误识别为本地数据库：

var rdb = new PouchDB('http://localhost:5984/r', 
                      { fetch: function (url, opts) { 
                                     opts.headers.set('X-Auth-CouchDB-Roles', '_admin'); 
                                     return PouchDB.fetch(url, opts); 
                                } 
                      });

步骤2：修改CouchDB CORS配置 #

找到CouchDB的配置文件local.ini，新增/修改[cors]段配置：

[cors]
enabled = true
origins = http://localhost:8080
credentials = true
methods = GET, PUT, POST, HEAD, DELETE, OPTIONS
headers = accept, authorization, content-type, origin, referer, x-auth-couchdb-roles

注意：headers配置必须包含你自定义的x-auth-couchdb-roles，否则预检请求仍会被拦截
你也可以直接访问CouchDB自带的Fauxton管理后台（默认地址http://localhost:5984/_utils），在配置板块找到CORS相关选项，直接在界面上修改上述参数。

步骤3：重启CouchDB服务 #

修改配置后重启CouchDB让规则生效，重新测试前端请求即可解决CORS报错。

如果只是本地调试不想修改CouchDB配置，可以给前端开发服务配置反向代理，将CouchDB相关请求转发到5984端口，同源请求不会触发CORS校验。以Vite配置为例：

// vite.config.js 示例
export default {
  server: {
    proxy: {
      '/r': {
        target: 'http://localhost:5984',
        changeOrigin: true
      }
    }
  }
}

对应PouchDB连接地址直接写/r即可，不需要加完整的域名端口。

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