树莓派Python Google Calendar脚本定期需重新认证问题排查

问题分析与解决方案 #

1. 定期重新认证的原因 #

• Testing状态是核心诱因：Google对未发布的Testing状态应用有严格的OAuth令牌限制：
  对于使用个人Google账号的外部测试用户（即使是开发者本人），刷新令牌的有效期仅为7天，访问令牌有效期为1小时。你遇到的1小时后需重新认证的情况，大概率是刷新过程中因树莓派网络稳定性问题、Google API访问超时（即日志中的TimeoutError）导致刷新失败，触发了脚本的退出流程，而非令牌本身立即失效，但Testing状态的令牌限制是长期问题的根源。
• 刷新逻辑的潜在触发点：creds.valid的判断可能存在延迟，或网络超时导致creds.refresh(Request())调用失败，被捕获为RefreshError，进而触发重新认证提示。

2. 长期稳定认证的推荐方案 #

针对个人无人值守脚本，优先推荐以下两种方案：

方案一：使用服务账号（最优选择）

服务账号无需手动认证，也不存在刷新令牌失效问题，完全适配定时运行的场景，步骤如下：

1. 在Google Cloud Console中创建服务账号，下载JSON格式的密钥文件
2. 打开目标Google Calendar的设置，将服务账号的邮箱地址添加为查看者权限
3. 修改认证逻辑，替换为服务账号认证：

from google.oauth2 import service_account
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/calendar.readonly']
SERVICE_ACCOUNT_FILE = 'path/to/your/service-account-key.json'

# 加载服务账号凭据
creds = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

# 构建Calendar服务
service = build('calendar', 'v3', credentials=creds)

方案二：将应用设为Internal（仅适用于Google Workspace账号）

如果你的Google账号属于Google Workspace（原G Suite），可将OAuth consent screen设置为Internal类型，此时刷新令牌无有效期限制，可长期使用。

方案三：临时延长Testing状态令牌有效期（不推荐长期使用）

在Google Cloud Console的OAuth consent screen设置中，可延长测试用户的令牌有效期，但这只是临时手段，Google仍会限制未发布应用的令牌生命周期，无法解决根本问题。

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