Azure Cosmos DB中用户定义函数（UDF）返回结果异常问题排查

我来帮你一步步排查这个UDF的问题，先从最容易踩的几个坑说起：

1. 先确认UDF的返回类型是否匹配_ts的类型 #

Cosmos DB的_ts字段是秒级Unix整数时间戳，如果你的UDF返回的是Date对象、字符串或者毫秒级时间戳，和整数直接比较就会出问题。

举个典型的错误UDF写法：

function getYesterday() {
  const yesterday = new Date();
  yesterday.setDate(yesterday.getDate() - 1);
  return yesterday; // 返回的是Date对象，不是整数时间戳！
}

这种情况下，c._ts >= udf.getYesterday()的比较逻辑完全不对，自然查不到正确结果。

正确的写法应该返回秒级整数：

function getYesterdayTimestamp() {
  const yesterday = new Date();
  yesterday.setDate(yesterday.getDate() - 1);
  // 把Date转成秒级时间戳，和_ts单位对齐
  return Math.floor(yesterday.getTime() / 1000);
}

2. 注意时区偏差问题 #

Azure Cosmos DB的UDF默认运行在UTC时区，如果你的代码用本地时区计算昨日，会导致时间戳偏差。比如你在东八区，本地时间的"昨日0点"对应UTC的"前一天16点"，直接用本地时间计算的话，得到的时间戳会比实际需要的UTC时间戳早8小时，导致查询结果不符合预期。

解决方法：强制用UTC时间计算昨日的起始时间戳：

function getYesterdayUTCTimestamp() {
  // 获取当前UTC的0点时间
  const todayUTCStart = new Date(Date.UTC(
    new Date().getUTCFullYear(),
    new Date().getUTCMonth(),
    new Date().getUTCDate()
  ));
  // 减去一天的毫秒数，得到昨日UTC0点
  const yesterdayUTCStart = new Date(todayUTCStart.getTime() - 24 * 60 * 60 * 1000);
  // 转成秒级时间戳
  return Math.floor(yesterdayUTCStart.getTime() / 1000);
}

3. 检查查询语句的UDF调用是否正确 #

很多时候是因为调用UDF时忘记加括号，比如写成了udf.getYesterdayTimestamp而不是udf.getYesterdayTimestamp()，这会把函数本身当成值来比较，肯定得不到正确结果。

正确的查询语句应该是：

SELECT * FROM c WHERE c._ts >= udf.getYesterdayUTCTimestamp()

4. 先单独验证UDF的返回值 #

你可以先执行一个简单的查询，直接查看UDF的返回结果：

SELECT udf.getYesterdayUTCTimestamp() AS yesterdayTs

把返回的整数和你的数据集里的_ts（1500000007、1500000005）对比，确认这个值是否是你预期的"昨日起始时间戳"，比如如果返回1500000006，那么查询应该返回第一条数据，这样就能快速定位是UDF的计算问题还是查询逻辑问题。

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