如何在Django中为flow.run_local_server()启用HTTPS并适配生产环境？

开发者阿泽

2026-7-9

解决Google OAuth2在HTTPS生产环境下无法使用run_local_server的问题

你的代码中使用的run_local_server()是Google OAuth2为本地桌面应用设计的方法，它启动的内置服务器不支持HTTPS，因此部署到启用SSL的生产环境后会失效。生产环境下需改用Web应用专属的授权码流程，结合Django的视图完成授权请求与回调处理。

修改后的完整代码及配置

1. 重构Drive类（适配Web OAuth2流程）

from __future__ import print_function
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload, MediaIoBaseDownload
from google_auth_oauthlib.flow import Flow
from google.oauth2.credentials import Credentials
from google.auth.exceptions import RefreshError
from google.auth.transport.requests import Request
from django.conf import settings
import os

class Drive:
    SCOPES = ['https://www.googleapis.com/auth/drive']
    extensions = {"csv": "text/csv", "mpeg": "video/mpeg"}
    # 凭证存储路径（建议生产环境改用数据库存储）
    TOKEN_PATH = os.path.join(settings.BASE_DIR, 'token.json')
    CLIENT_SECRETS_PATH = settings.GOOGLE_OAUTH2_CLIENT_SECRETS_JSON

    def __init__(self):
        self.creds = self.load_credentials()
        self.service = build('drive', 'v3', credentials=self.creds) if self.creds else None

    def load_credentials(self):
        """加载已存储的凭证，失效时尝试自动刷新"""
        creds = None
        if os.path.exists(self.TOKEN_PATH):
            creds = Credentials.from_authorized_user_file(self.TOKEN_PATH, self.SCOPES)
        
        # 凭证过期但有刷新令牌，尝试刷新
        if creds and not creds.valid:
            if creds.expired and creds.refresh_token:
                try:
                    creds.refresh(Request())
                    self.save_credentials(creds)
                except RefreshError:
                    creds = None  # 刷新失败，需重新授权
            else:
                creds = None
        return creds

    def save_credentials(self, creds):
        """将凭证保存到本地（多用户场景需改为按用户存储）"""
        with open(self.TOKEN_PATH, 'w') as token_file:
            token_file.write(creds.to_json())

    def get_auth_flow(self):
        """创建Web应用专用的OAuth2 Flow实例"""
        flow = Flow.from_client_secrets_file(
            self.CLIENT_SECRETS_PATH,
            scopes=self.SCOPES,
            redirect_uri=settings.GOOGLE_OAUTH2_REDIRECT_URI
        )
        return flow

2. 添加Django授权视图

在你的views.py中添加以下视图，处理授权跳转与回调：

from django.shortcuts import redirect, HttpResponse
from django.conf import settings
from .drive import Drive

def google_auth_init(request):
    """初始化授权，重定向到Google登录页面"""
    drive = Drive()
    flow = drive.get_auth_flow()
    
    # 生成授权URL，要求离线访问以获取刷新令牌
    authorization_url, state = flow.authorization_url(
        access_type='offline',
        include_granted_scopes='true'
    )
    
    # 存储状态用于CSRF验证
    request.session['oauth_state'] = state
    return redirect(authorization_url)

def google_auth_callback(request):
    """处理Google授权回调，获取并保存凭证"""
    drive = Drive()
    flow = drive.get_auth_flow()
    
    # 验证CSRF状态
    session_state = request.session.get('oauth_state')
    request_state = request.GET.get('state')
    if not session_state or session_state != request_state:
        return HttpResponse('无效的状态参数', status=400)
    
    # 用授权码交换凭证
    flow.fetch_token(authorization_response=request.build_absolute_uri())
    
    # 保存凭证
    drive.save_credentials(flow.credentials)
    
    # 授权完成后跳转到业务页面
    return redirect('/your-success-page/')

3. 配置Django参数与路由

在settings.py中添加OAuth2配置：

GOOGLE_OAUTH2_CLIENT_SECRETS_JSON = os.path.join(BASE_DIR, 'client_secret.json')
# 替换为你的HTTPS回调地址，需与Google Cloud Console配置一致
GOOGLE_OAUTH2_REDIRECT_URI = 'https://somedomain.com/google-auth-callback/'

在urls.py中添加路由：

from django.urls import path
from . import views

urlpatterns = [
    # ... 其他路由
    path('google-auth/', views.google_auth_init, name='google-auth-init'),
    path('google-auth-callback/', views.google_auth_callback, name='google-auth-callback'),
]

关键修改说明

替换InstalledAppFlow为Flow：Web应用专用的OAuth2流程类，支持配置HTTPS回调地址。
拆分授权流程：分为"初始化授权跳转"和"回调处理凭证"两步，符合Web应用交互逻辑。
增加CSRF验证：通过state参数防止跨站请求伪造。
启用离线访问：配置access_type='offline'获取刷新令牌，实现凭证自动刷新，无需用户重复授权。

生产环境注意事项

Google Cloud Console配置：确保OAuth2客户端ID的"授权重定向URI"与GOOGLE_OAUTH2_REDIRECT_URI完全一致（必须为HTTPS）。
凭证存储：当前代码用文件存储token.json，多用户/多实例场景建议改用数据库存储，避免文件竞争。
权限控制：如果是多用户应用，需为每个用户单独存储凭证，不能共用一个文件。

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