Python Flask应用接入Google Drive API部署Heroku后认证超时问题咨询
Heroku部署Flask应用实现Google Drive认证的排查修复方案
- 核对Google Cloud侧重定向URI授权配置
本地开发时使用的回调地址多为http://localhost:本地端口/oauth2/callback,部署到Heroku后必须将线上应用的完整回调地址(格式为https://<你的Heroku应用名称>.herokuapp.com/代码中定义的OAuth回调路由路径)逐字符匹配,添加到Google Cloud Console OAuth同意屏的已授权重定向URI列表中。禁止仅填写主域名、遗漏https协议、混入多余空格,否则Google完成授权后无法识别合法跳转目标,直接中断流程。 - 移除硬编码的本地认证配置
不要将本地开发用的client_secret.json文件直接打包进Heroku部署包,这类文件内置的回调地址为本地开发地址,线上运行时会导致授权参数完全不匹配。需要将OAuth依赖的client_id、client_secret、线上回调地址全部配置为Heroku环境变量,代码内通过os.environ.get()读取对应参数。 - 适配Heroku反向代理的协议识别逻辑
Heroku负载均衡层会将外部HTTPS请求转换为内部HTTP请求发送给Flask应用,默认配置下Flask生成的回调地址会被误判为HTTP协议,与Google侧配置的HTTPS回调地址不匹配。需要在Flask初始化代码中添加代理适配代码:
保证应用正确识别请求的原始协议与域名,生成与Google侧配置完全一致的授权跳转链接。from werkzeug.middleware.proxy_fix import ProxyFix app.wsgi_app = ProxyFix(app.wsgi_app, x_for=1, x_proto=1, x_host=1, x_prefix=1) - 调整会话存储逻辑适配分布式部署特性
本地运行时Flask默认将会话数据存在单实例内存中,但Heroku的应用请求会被随机路由到不同运行实例上,OAuth流程依赖的state校验参数、临时授权状态如果仅存储在单实例内存中,回调请求到达其他实例时会因读取不到历史会话状态直接中断流程。对应修复方式:- 接入持久化会话存储(如Redis插件),让所有运行实例共享同一份会话数据
- 将OAuth流程中的临时加密状态存储在客户端Cookie中,不依赖服务端内存会话
- 校验回调路由的拦截规则
确认代码中定义的OAuth回调路由没有被全局登录校验、CSRF校验、权限拦截中间件拦截。如果回调请求被中间件强制跳转,无法进入token交换的核心逻辑,就会出现授权完成后流程卡死的现象。
内容的提问来源于stack exchange,提问作者Brezipat
相关产品推荐
相关产品推荐

