Google Cloud Function中gspread_pandas报TypeError: 'AuthorizedSession'不可调用

问题定位 #

这个错误TypeError: 'AuthorizedSession' object is not callable通常源于两个核心原因：

1. Python 3.12与gspread-pandas依赖的google-auth等库版本不兼容，导致内部对象调用逻辑出错；
2. 从Secret Manager加载凭证到环境变量的方式不符合GCF部署环境的要求（比如直接将JSON字符串赋值给GOOGLE_APPLICATION_CREDENTIALS，而非指向凭证文件路径）。

解决方案 #

方案1：锁定兼容的依赖版本 #

Python 3.12属于较新版本，部分旧版依赖库可能未适配其特性。在requirements.txt中明确指定兼容的版本：

functions-framework==3.*
gspread-pandas==3.2.0
google-auth==2.23.0
google-cloud-secret-manager==2.19.0

这些版本经过验证可在Python 3.12的GCF环境中正常配合工作，避免依赖自动升级带来的兼容性问题。

方案2：手动构建凭证对象（推荐） #

绕过gspread-pandas自动从环境变量加载凭证的流程，直接从Secret Manager获取凭证并构建授权对象，彻底规避环境变量解析的潜在问题：

import json
from google.cloud import secretmanager
from gspread_pandas import Spread, Client
from google.oauth2.service_account import Credentials

def access_secret_version(project_id, secret_id, version_id="latest"):
    client = secretmanager.SecretManagerServiceClient()
    name = f"projects/{project_id}/secrets/{secret_id}/versions/{version_id}"
    response = client.access_secret_version(name=name)
    return response.payload.data.decode("UTF-8")

def your_cloud_function(request):
    # 从Secret Manager读取凭证JSON并解析
    creds_info = json.loads(access_secret_version("你的项目ID", "你的凭证密钥ID"))
    # 定义所需权限范围
    scopes = [
        "https://www.googleapis.com/auth/spreadsheets",
        "https://www.googleapis.com/auth/drive"
    ]
    # 手动构建Credentials对象
    creds = Credentials.from_service_account_info(creds_info, scopes=scopes)
    # 初始化gspread-pandas的Client和Spread
    gs_client = Client(creds=creds)
    spread = Spread("你的表格ID", client=gs_client)
    
    # 执行你的业务逻辑，比如读取数据
    df = spread.sheet_to_df()
    
    return "执行成功"

方案3：修正环境变量加载方式（若坚持用环境变量） #

GOOGLE_APPLICATION_CREDENTIALS环境变量要求的值是凭证文件的路径，而非JSON字符串。部署到GCF时需要将Secret Manager获取的JSON写入临时文件，再指定路径：

import os
import json
import tempfile
from google.cloud import secretmanager
from gspread_pandas import Spread

def access_secret_version(project_id, secret_id, version_id="latest"):
    client = secretmanager.SecretManagerServiceClient()
    name = f"projects/{project_id}/secrets/{secret_id}/versions/{version_id}"
    response = client.access_secret_version(name=name)
    return response.payload.data.decode("UTF-8")

def your_cloud_function(request):
    creds_json = access_secret_version("你的项目ID", "你的凭证密钥ID")
    # 创建临时文件存储凭证
    with tempfile.NamedTemporaryFile(mode='w', delete=False, suffix='.json') as temp_file:
        temp_file.write(creds_json)
        temp_path = temp_file.name
    
    # 设置环境变量指向临时文件
    os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = temp_path
    
    # 初始化Spread
    spread = Spread("你的表格ID")
    df = spread.sheet_to_df()
    
    # 清理临时文件（GCF函数结束后实例会销毁，可选操作）
    os.unlink(temp_path)
    
    return "执行成功"

为什么本地正常部署出错？ #

• 本地环境的依赖版本可能与GCF自动安装的版本不一致（比如本地用的是兼容Python3.12的旧版google-auth，而GCF默认拉取了最新版）；
• 本地可能通过其他方式正确配置了凭证文件路径，而部署时直接将JSON字符串赋值给环境变量，导致gspread-pandas内部解析出错。

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