Python谷歌授权出现'creds'未赋值即引用错误，求排查方案

问题背景 #

一段谷歌授权Python代码此前运行正常，今日突然在creds.refresh(Request())行抛出local variable 'creds' referenced before assignment错误，但在调用该方法前能正常打印出creds对象（<google.oauth2.credentials.Credentials object at 0x110097c70>）。

排查解决步骤 #

1. 捕获refresh方法的具体异常 #

外层try块会掩盖refresh过程中的详细错误信息，给refresh单独加异常捕获，明确失败原因：

if creds and creds.expired and creds.refresh_token:
    print(f"{cm.WARNING}Refreshing token...{cm.ENDC}")
    print(f"当前creds对象: {creds}")
    try:
        creds.refresh(Request())
    except Exception as refresh_err:
        print(f"刷新token失败，错误详情: {refresh_err}")
        raise  # 重新抛出异常，查看完整栈跟踪

很多时候，变量未定义的错误提示是表象，实际是refresh执行时抛出的异常触发了异常处理流程，导致后续代码逻辑异常。

2. 检查token.json文件状态 #

• 打开token.json，确认refresh_token字段存在且不为空，文件格式是合法的JSON。
• 检查文件权限：确保当前运行代码的用户有读写该文件的权限，避免因权限问题导致加载或保存失败。

3. 验证Request类的导入正确性 #

确认导入的Request类是谷歌授权所需的正确类：

from google.auth.transport.requests import Request

如果导入了错误的Request类（比如其他库的同名类），会导致refresh方法执行异常，进而出现误导性的变量错误提示。

4. 打印creds对象的关键属性 #

在refresh前打印更多属性，确认状态符合预期：

print(f"creds是否有效: {creds.valid}")
print(f"creds是否过期: {creds.expired}")
print(f"refresh_token值: {creds.refresh_token}")

排查是否存在属性值异常（比如refresh_token为空字符串但被判断为True），导致进入refresh分支但实际无法执行刷新操作。

5. 强制重新授权测试 #

临时注释掉refresh分支的代码，强制走重新授权流程：

# if creds and creds.expired and creds.refresh_token:
#     print(f"{cm.WARNING}Refreshing token...{cm.ENDC}")
#     creds.refresh(Request())
# else:
credsPath = os.path.expanduser("~/Desktop/xxxxxx/Development/Python/xxxxxxxx/modules/credentials.json") 
flow = InstalledAppFlow.from_client_secrets_file(credsPath, SCOPES)
creds = flow.run_local_server(port=0)

如果重新授权后代码正常运行，说明旧的refresh_token已失效（被吊销或过期），此时refresh操作失败，错误提示因异常处理被误导。

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