CouchDB(nano)登录后数据库连接随机403，重启Express后恢复

我已经在Node.js Express应用中集成了用户认证功能，认证后会在Cookie中返回JWT，功能运行正常。但登录后发起无需权限校验的公开数据库连接请求时，会随机出现403错误。诡异的是，重启Express应用后，相同的请求又能正常执行。

登录函数代码 #

const login = async (username, password) => {
  try {
    const response = await connection.auth(username, password)
    if (!response.ok) {
      return [401, null]
    }

    const token = jwt.sign({ sub: username }, secret, { expiresIn: '1h' })
    return [null, token]
  } catch (error) {
    return [error, null]
  }
}

数据库连接代码（随机403时进入catch块） #

try {
  const conn = await nano('http://admin:password@127.0.0.1:5984')
  const db = await conn.use('test')
  // 后续数据库操作
} catch (error) {
  console.error(error)
  return [error, null]
}

1. 修复nano连接复用问题 #

nano默认会复用HTTP连接池中的连接，若CouchDB回收了旧会话，复用的连接会因认证信息失效返回403，重启应用后连接池重置就恢复正常。

• 解决方案：禁用连接复用，每次请求创建新连接实例：

  const conn = nano({
    url: 'http://admin:password@127.0.0.1:5984',
    requestDefaults: {
      agent: false // 关闭HTTP Agent复用
    }
  })
  

2. 避免依赖CouchDB认证缓存 #

CouchDB的HTTP认证会话可能过期，但nano仍在复用旧连接的缓存信息。

• 解决方案：每次连接前显式执行认证：

  const conn = nano('http://127.0.0.1:5984')
  await conn.auth('admin', 'password') // 每次连接前重新认证
  const db = await conn.use('test')
  

3. 排除Express中间件干扰 #

部分全局中间件可能会把请求上下文的Cookie/JWT头带到nano的数据库请求中，导致CouchDB收到无效认证信息返回403。

• 解决方案：创建nano连接时清空继承的请求头：

  const conn = nano({
    url: 'http://admin:password@127.0.0.1:5984',
    requestDefaults: {
      headers: {
        Cookie: undefined,
        Authorization: undefined
      }
    }
  })
  

4. 查看CouchDB日志定位根因 #

直接查看CouchDB的日志文件（通常在安装目录logs文件夹或系统/var/log/couchdb/路径下），日志会明确标注403错误的具体原因（如认证失败、权限配置问题等），能精准定位问题。

内容的提问来源于stack exchange，提问作者YeppThat'sMe