Google Calendar API在Netlify部署的无服务器函数中返回重复事件且存在结果缺失问题

看起来你遇到的问题很典型——本地开发一切正常，但部署到Netlify后就出现了事件重复、部分结果丢失的情况，而且移除timeMax就恢复正常，这大概率和生产环境的时间/时区差异或者日期参数计算不一致有关。我来帮你拆解下可能的原因和解决办法：

核心原因分析 #

1. 时区不匹配：你的日历时区是America/Chicago，但Netlify的服务器默认使用UTC时区。如果本地计算today和tomorrow时依赖了本地时区（比如直接用new Date()），那么生产环境生成的timeMin/timeMax会和本地有偏差，导致API返回的事件范围不符合预期，甚至包含重复的事件实例。
2. 日期计算的环境差异：打包过程中如果某些日期处理逻辑被静态优化（比如使用了某些会在构建时计算日期的库），或者原生Date方法在不同环境下的表现细微差异，也会导致时间范围参数出错。

具体解决步骤 #

1. 强制指定时区计算时间范围 #

不要依赖服务器或本地环境的默认时区，直接针对你的日历时区（America/Chicago）来计算timeMin和timeMax，确保本地和生产环境生成的参数完全一致。

用原生JS实现的话可以这样写：

const targetTimeZone = 'America/Chicago';

// 计算芝加哥时区的"今天0点"
const todayStart = new Date(new Date().toLocaleString('en-US', { timeZone: targetTimeZone }));
todayStart.setHours(0, 0, 0, 0);

// 计算芝加哥时区的"明天0点"（作为timeMax，排他性，即不包含明天0点及以后的事件）
const tomorrowStart = new Date(todayStart);
tomorrowStart.setDate(tomorrowStart.getDate() + 1);

// 转换为API要求的ISO格式字符串
const timeMin = todayStart.toISOString();
const timeMax = tomorrowStart.toISOString();

如果用moment-timezone库会更简洁：

const moment = require('moment-timezone');
const targetTimeZone = 'America/Chicago';

const timeMin = moment.tz(targetTimeZone).startOf('day').toISOString();
const timeMax = moment.tz(targetTimeZone).add(1, 'day').startOf('day').toISOString();

2. 验证生产环境的参数值 #

在Netlify函数中添加日志，输出timeMin和timeMax的实际值，对比本地开发环境的参数，确认两者是否一致：

console.log(`[Calendar API Request] timeMin: ${timeMin}, timeMax: ${timeMax}`);

然后去Netlify后台的函数日志里查看这些输出，如果发现生产环境的时间参数和本地不一样，那就能坐实时区差异的问题。

3. 检查重复事件的时间范围 #

你返回的重复事件ID是7e5jjq2eos56vn0dsrcr3bgbod_20210428T233000Z和7e5jjq2eos56vn0dsrcr3bgbod_20210429T233000Z，这是同一个重复事件的不同实例。如果timeMax的计算刚好覆盖了第二天的这个实例，就会被错误包含进来——这也验证了时间范围参数的问题。

4. 清理Netlify构建缓存 #

有时候Netlify会复用旧的构建缓存，导致修改后的日期逻辑没有生效。你可以在Netlify项目的Deploys页面，找到最新的部署记录，点击Clear cache and deploy site重新部署，确保代码是最新的。

额外注意点 #

Google Calendar API的timeMax是排他性参数——它只返回开始时间早于timeMax的事件。如果你的事件是跨天的（比如从当天23:30到次日00:30），要确保timeMax的设置不会错误地排除或包含这些事件。

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