调度Firestore自动备份时出错，寻求解决方案

错误根源分析 #

你遇到的TypeError: Cannot read properties of undefined (reading 'charCodeAt')错误，本质是google-gax库在解析路径模板时接收到了未定义的字符串参数。结合你的代码，大概率是process.env.GCLOUD_PROJECT环境变量未正确加载，导致client.databasePath生成的数据库路径无效。

具体排查步骤 #

1. 验证环境变量是否存在 #

在函数开头添加日志，确认GCLOUD_PROJECT的实际值：

exports.scheduledFirestoreExport = (event, context) => {
  console.log('当前项目ID:', process.env.GCLOUD_PROJECT); // 新增验证日志
  console.log('in function');
  // 后续代码保持不变
};

2. 临时硬编码项目ID测试 #

为快速定位问题，直接将项目ID写死到代码中测试：

const databaseName = client.databasePath(
  '你的实际Google Cloud项目ID', // 替换为真实项目ID
  '(default)'
);

如果函数能正常运行，说明问题出在环境变量配置上。

3. 修复环境变量配置 #

• 登录Google Cloud Console，进入目标云函数的详情页
• 切换到环境变量、网络、超时标签页
• 在环境变量区域添加GCLOUD_PROJECT，值为你的项目ID，保存后重新部署函数

4. 查看云函数日志的正确方式 #

• 控制台方式：进入云函数详情页，切换到日志标签页，所有console.log/console.error的输出都会在这里显示
• 命令行方式：执行以下命令获取日志：

  gcloud functions logs read scheduledFirestoreExport --project 你的项目ID
  

5. 检查存储桶权限 #

确保云函数的默认服务账号拥有存储桶的读写权限：

• 进入存储桶gs://my_firestore_backup的权限设置页面
• 添加云函数的服务账号（格式为PROJECT_ID@appspot.gserviceaccount.com），并授予Storage Object Creator和Storage Object Viewer角色

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