使用react-google-apps-script时Session与PropertiesService为何未定义？

云原生阿岚

2026-8-15

问题原因及解决方案

核心原因

你遇到的Session、PropertiesService未定义问题，主要来自两个方面：

OAuth权限缺失：这两个API需要特定的授权范围，若appscript.json未配置对应权限，会导致调用时出现对象未定义或权限报错。
函数暴露/执行上下文问题：react-google-apps-script的打包机制要求服务端函数必须正确导出，才能被识别为GAS可调用函数，否则可能在错误的上下文执行。

具体解决步骤

1. 补充OAuth权限到appscript.json

打开appscript.json，在oauthScopes数组中添加以下必要权限：

"oauthScopes": [
  "https://www.googleapis.com/auth/spreadsheets",
  "https://www.googleapis.com/auth/userinfo.email", // 用于Session.getActiveUser()
  "https://www.googleapis.com/auth/script.properties", // 用于PropertiesService
  "https://www.googleapis.com/auth/script.external_request"
]

2. 确保服务端函数正确导出

在server目录下的文件中，按ES模块语法导出服务端函数，示例：

// server/userFunctions.js
export function getActiveUserEmail() {
  return Session.getActiveUser().getEmail();
}

export function getAppProperty(key) {
  return PropertiesService.getScriptProperties().getProperty(key);
}

3. 客户端正确调用服务端函数

客户端通过import引入服务端函数后，需以异步方式调用（react-google-apps-script会自动封装为google.script.run调用）：

// client/ProfileComponent.jsx
import { getActiveUserEmail } from '../server/userFunctions';

const loadUserEmail = async () => {
  try {
    const email = await getActiveUserEmail();
    console.log('当前用户邮箱:', email);
  } catch (error) {
    console.error('获取邮箱失败:', error);
  }
};