通过CI/CD部署Pub/Sub云函数时Cloud Scheduler时区无法修改且自动fallback至默认时区的问题求助

我之前碰到过一模一样的Cloud Scheduler时区失效问题，结合你的代码和已经排查过的点，下面几个方向应该能帮你解决问题：

1. 重点检查firebase-functions依赖版本 #

你提到升级了firebase-admin，但时区配置的核心逻辑其实在firebase-functions包里，旧版本可能存在时区解析的bug，导致部署时没有正确传递时区参数。

• 操作步骤：
  • 先查看当前版本：npm list firebase-functions
  • 升级到最新稳定版：npm install firebase-functions@latest --save
  • 重新部署函数：firebase deploy --only functions

2. 验证CI/CD流水线的环境配置 #

有些CI/CD环境会默认覆盖或遗漏关键环境变量，导致部署过程中时区配置没有被正确应用。

• 建议：
  • 在流水线中添加部署前的环境检查，确保GOOGLE_CLOUD_PROJECT等必要变量已正确设置
  • 本地模拟CI的部署命令，看看能不能复现问题，排除流水线本身的配置错误

3. 手动核对Cloud Scheduler的实际任务配置 #

有时候部署后，Cloud Scheduler的任务配置并没有同步更新，需要手动确认：

• 操作步骤：
  • 打开Google Cloud Console进入Cloud Scheduler页面
  • 找到对应的定时任务，查看时区字段是否显示为America/New_York
  • 如果显示错误，可以先手动修改时区，再测试任务执行时间是否符合预期

4. 加日志确认实际执行时区 #

可以在函数里添加日志，输出当前运行的时区和时间，这样能直接验证函数实际运行时的时区是否正确：

exports.scheduledFunctionCrontab = functions.pubsub.schedule('0 11 * * *')
  .timeZone('America/New_York')
  .onRun((context) => {
    const currentTime = new Date();
    const runtimeTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
    console.log(`Runtime timezone: ${runtimeTimezone}, current time: ${currentTime.toString()}`);
    console.log('Expected to run at 11:00 AM Eastern!');
    return null;
  });

部署后查看函数日志，如果时区显示不是America/New_York，那说明部署过程中时区配置确实没生效。

5. 确认部署到了正确的GCP项目 #

如果CI/CD流水线指定的项目ID和你预期的不一致，可能任务部署到了另一个项目里，你查看的是当前项目的配置，自然看不到正确的时区设置。

• 操作步骤：
  • 检查CI脚本里的firebase deploy命令是否带了--project参数，且参数值是正确的项目ID
  • 登录对应GCP项目的Cloud Scheduler页面，确认任务是否存在

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