FireStore自动导出Google Sheets脚本执行无数据显示问题排查

我需要将Firestore数据库自动导出至Google Sheets，编写了如下Apps Script函数：

function exportFirestoreToSheets() {
  // Connect to FireStore
  
  const email = "###.gserviceaccount.com";
  const key = "-----BEGIN PRIVATE KEY-----###\n-----END PRIVATE KEY-----\n";
  const projectId = "moked-report";

  const firestore = FirestoreApp.getFirestore(email, key, projectId);
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName("moked reports data"); // Change this to your desired sheet name
  // If the sheet doesn't exist, create it
  if (!sheet) {
    sheet = ss.insertSheet("moked reports data");
  }

  const allDocuments = firestore.getDocuments("reports");
  
  allDocuments.forEach((doc, index) => {
    const data = doc.fields; // Assuming the document structure is represented as fields
    const rowData = Object.values(data);
    // Write data to the next available row in the sheet
    sheet.getRange(index + 1, 1, 1, rowData.length).setValues([rowData]);
  });
}

脚本执行显示“Execution completed”，但看不到目标表格或数据；调试确认已获取到Firestore集合数据，但写入失败。

以下是几个核心问题的修复方案，直接对应你的代码问题：

• 处理Firestore特殊数据类型
  Firestore返回的字段可能包含Timestamp、DocumentReference这类Apps Script无法直接写入表格的类型，必须先转换：

// 新增数据类型转换辅助函数
function convertFirestoreValue(value) {
  if (value instanceof FirestoreApp.Timestamp) {
    return value.toDate(); // 转成Sheets可识别的日期对象
  } else if (value instanceof FirestoreApp.DocumentReference) {
    return value.path; // 存储引用路径而非对象
  } else if (Array.isArray(value)) {
    return value.map(convertFirestoreValue); // 递归处理数组
  } else if (typeof value === 'object' && value !== null) {
    return JSON.stringify(value); // 嵌套对象转成JSON字符串方便查看
  }
  return value; // 基础类型直接返回
}

• 替换逐行写入为批量写入
  逐行调用setValues不仅效率低，还容易触发Google服务调用限制，改成一次性写入所有数据：

// 替换原forEach循环部分
const rows = [];
// 可选：添加字段名作为表头
if (allDocuments.length > 0) {
  rows.push(Object.keys(allDocuments[0].fields));
}
// 批量处理所有文档数据
allDocuments.forEach(doc => {
  const rowData = Object.values(doc.fields).map(convertFirestoreValue);
  rows.push(rowData);
});
// 一次性写入表格
if (rows.length > 0) {
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}

• 强制刷新表格操作
  有时候写入操作会延迟，添加刷新指令确保数据即时显示：

// 在创建表格后激活它
ss.setActiveSheet(sheet);
// 写入数据后强制提交所有操作
SpreadsheetApp.flush();

function exportFirestoreToSheets() {
  const email = "###.gserviceaccount.com";
  const key = "-----BEGIN PRIVATE KEY-----###\n-----END PRIVATE KEY-----\n";
  const projectId = "moked-report";

  const firestore = FirestoreApp.getFirestore(email, key, projectId);
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName("moked reports data");
  
  if (!sheet) {
    sheet = ss.insertSheet("moked reports data");
    ss.setActiveSheet(sheet);
  }

  const allDocuments = firestore.getDocuments("reports");
  if (allDocuments.length === 0) return;

  // 转换Firestore数据类型的辅助函数
  function convertFirestoreValue(value) {
    if (value instanceof FirestoreApp.Timestamp) {
      return value.toDate();
    } else if (value instanceof FirestoreApp.DocumentReference) {
      return value.path;
    } else if (Array.isArray(value)) {
      return value.map(convertFirestoreValue);
    } else if (typeof value === 'object' && value !== null) {
      return JSON.stringify(value);
    }
    return value;
  }

  const rows = [];
  // 添加表头
  rows.push(Object.keys(allDocuments[0].fields));
  // 处理所有文档数据
  allDocuments.forEach(doc => {
    const rowData = Object.values(doc.fields).map(convertFirestoreValue);
    rows.push(rowData);
  });

  // 批量写入数据
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
  SpreadsheetApp.flush();
}

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