Firebase PubSub定时函数部署报调度或时区无效错误的排查

之前遇到的400报错是两个配置问题叠加导致，和时区配置本身无关

• 调度规则语法非法：.schedule('every 24 hours 00:00') 不符合Cloud Scheduler的cron语法规范，是触发「Schedule or time zone is invalid」报错的核心原因
• 区域入参非法：eur3、europe-west都不是Firebase Functions .region()方法支持的合法参数，SDK识别后会自动回退到默认的europe-west1区域，导致调度作业的实际生成位置和预期不符
• 时区配置Africa/Johannesburg本身是合法IANA时区ID，不存在配置错误

直接沿用现有onCall函数的区域配置即可，不需要刻意匹配GCP层面的eur3多区域标识：

• 区域参数保持.region('europe-west2')，该区域是Cloud Scheduler在欧洲支持的合法单区域，和eur3多区域属于同一地域集群，不存在兼容性问题
• 替换为合法的cron表达式，实现每天00:00（约翰内斯堡时区）执行，有两种等价写法可选：
  • 标准cron格式：0 0 * * *（对应「每小时0分、每天0点、每月每日、每周任意一天」执行）
  • Firebase兼容的友好写法：every day 00:00
• 时区配置保留.timeZone('Africa/Johannesburg')即可

配置前后代码对比
原错误代码：

exports.dailyTasks = functions
  .region('eur3') // 非法区域入参
  .pubsub
  .schedule('every 24 hours 00:00') // 非法cron语法
  .timeZone('Africa/Johannesburg')
  .onRun(...);

修正后可部署代码：

exports.dailyTasks = functions
  .region('europe-west2') // 合法单区域入参，和现有onCall函数配置一致
  .pubsub
  .schedule('0 0 * * *') // 或写为'every day 00:00'
  .timeZone('Africa/Johannesburg')
  .onRun(...);

Firebase不会在部署函数时自动创建GAE应用，这是Cloud Scheduler的强制前置要求，需手动完成初始化：

• 登录关联workouts-uat项目的Google Cloud Console账号
• 顶部搜索栏搜索「App Engine」，进入产品页面
• 首次进入会触发创建引导，第一步选择区域时，匹配项目现有eur3（欧洲多区域）的配置选项即可
• 运行时语言可任意选择（后续函数运行不依赖该选项），确认后等待1-2分钟完成初始化
• 不需要上传任何业务代码，只要GAE应用处于创建完成状态，即可正常支撑定时函数的调度作业创建

• 不要尝试在.region()方法中传入GCP多区域标识（如eur3、nam3），该方法仅支持Firebase官方定义的单区域ID
• 部署前可先在GCP控制台确认GAE应用已创建完成，未完成初始化的项目会直接阻断Cloud Scheduler作业创建
• 如果修正配置后仍提示时区错误，可检查时区ID是否拼写正确，Africa/Johannesburg是唯一合法的约翰内斯堡时区标识，不要简写

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