CouchDB使用startkey和endkey多键传参时含日期返回空数组问题

我来帮你排查这个头疼的问题——只传员工编号和姓名能拿到数据，加上日期范围就返回空，大概率是键的格式不匹配或者视图定义有问题，下面是具体的排查和解决步骤：

1. 检查视图Map函数的日期输出格式 #

CouchDB的视图查询完全依赖emit输出的键和查询参数的类型、顺序、格式完全一致。你需要确保Map函数里的日期和你查询时用的[年,月,日]数组格式完全匹配：

示例正确的Map函数 #

如果你的WorkDate是ISO字符串（比如"2018-02-04"），可以这样处理：

function(doc) {
  // 只处理Work类型的文档
  if (doc.type === "Work") {
    // 拆分日期字符串为数字数组
    const dateParts = doc.WorkDate.split("-").map(Number);
    // 输出键：[员工编号, 员工姓名, [年,月,日]]
    emit([doc.EmployeeNumber, doc.EmployeeName, dateParts], doc.hrs);
  }
}

如果WorkDate是可转换为Date的字符串，要注意月份是从0开始的，必须加1才能和你查询的2（二月）对应：

function(doc) {
  if (doc.type === "Work") {
    const workDate = new Date(doc.WorkDate);
    const dateArray = [
      workDate.getFullYear(),
      workDate.getMonth() + 1, // getMonth()返回0-11，所以要+1
      workDate.getDate()
    ];
    emit([doc.EmployeeNumber, doc.EmployeeName, dateArray], doc.hrs);
  }
}

2. 确保查询参数的类型和文档一致 #

CouchDB对数据类型非常敏感：

• 如果文档里EmployeeNumber是数字类型（比如91444），但你查询时用的是字符串"91444"，就会因为类型不匹配查不到数据
• 日期数组里的元素必须是数字，不能用字符串（比如不能写成["2018","2","4"]）

3. 修正查询参数的格式错误 #

你当前的查询参数里endkey = ["91444","Rick",[2018,2,15]]有个多余的空格，这会导致CouchDB解析参数出错，应该去掉等号后面的空格：

?startkey=["91444","Rick",[2018,2,4]]&endkey=["91444","Rick",[2018,2,15]]

4. 确保视图已完成索引 #

如果是刚添加的文档，CouchDB可能还没完成视图索引，你可以：

• 直接访问视图的基础URL（不带查询参数），手动触发索引构建
• 等待几分钟，让CouchDB自动完成索引更新

5. 验证Reduce函数配置 #

因为你需要的是SUM(hrs)，视图必须配置Reduce函数为_sum：

• 在CouchDB的视图设置里，将Reduce选项设为_sum
• 查询时不需要额外参数，CouchDB会自动返回总和

快速测试技巧 #

你可以先不带日期范围查询，看看返回的键格式是什么样的：

?startkey=["91444","Rick"]&endkey=["91444","Rick",{}]

这样会返回该员工的所有Work记录，对比返回的键里的日期数组和你查询时用的是否一致，就能快速定位格式问题。

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