Python网站中Dropbox令牌过期后如何通过刷新令牌获取新令牌？

核心思路是不要把短期有效的访问令牌存在仅启动时加载的settings里，而是把刷新逻辑移到运行时，每次调用Dropbox API前确保拿到的是有效令牌。以下是具体实现方案：

1. 保留长期有效配置在settings.py #

把不会过期的配置留在settings里，这些是长期有效的：

# settings.py
DROPBOX_APP_KEY = '你的App Key'
DROPBOX_APP_SECRET = '你的Secret Key'
DROPBOX_REFRESH_TOKEN = '你的刷新令牌'

2. 写一个动态获取有效令牌的工具函数 #

创建一个工具模块（比如dropbox_utils.py），用全局变量缓存当前令牌和过期时间，每次调用时自动检查并刷新：

# dropbox_utils.py
import time
from dropbox import Dropbox, exceptions
from django.conf import settings

# 缓存当前访问令牌和过期时间
_current_access_token = None
_token_expires_at = 0

def get_valid_dropbox_client():
    global _current_access_token, _token_expires_at
    now = time.time()

    # 令牌未初始化或即将过期（提前60秒刷新，避免刚好过期的请求失败）
    if not _current_access_token or now >= _token_expires_at - 60:
        # 用刷新令牌获取新的访问令牌
        dbx = Dropbox(
            app_key=settings.DROPBOX_APP_KEY,
            app_secret=settings.DROPBOX_APP_SECRET,
            oauth2_refresh_token=settings.DROPBOX_REFRESH_TOKEN
        )
        auth_result = dbx.refresh_access_token()
        _current_access_token = auth_result.access_token
        _token_expires_at = now + auth_result.expires_in

    # 返回带有效令牌的客户端实例
    return Dropbox(oauth2_access_token=_current_access_token)

3. 在业务代码中使用工具函数替换直接调用 #

所有需要访问Dropbox API的地方，都通过这个工具函数获取客户端：

# 业务视图或逻辑中
from .dropbox_utils import get_valid_dropbox_client

def handle_dropbox_files():
    try:
        dbx = get_valid_dropbox_client()
        # 执行API操作，比如列出文件
        result = dbx.files_list_folder('/')
        # 处理返回结果
        return result.entries
    except exceptions.AuthError:
        # 捕获认证错误，说明刷新令牌可能已失效，需要引导用户重新授权
        raise Exception("Dropbox授权失效，请重新绑定账号")

关键说明 #

• 提前60秒刷新令牌是为了避免在请求过程中刚好遇到令牌过期的情况，提升稳定性。
• 如果仍触发AuthError，大概率是刷新令牌本身失效了（比如用户取消了授权），这时候需要引导用户重新完成OAuth流程获取新的刷新令牌。
• 非Django项目只需把settings的配置读取方式换成对应框架的配置读取逻辑即可，核心逻辑完全通用。

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