2026-11-21·5 分钟
Google 配置:OAuth 与凭据管理
Google Cloud Console 从零创建 OAuth 客户端、配置回调地址、发布同意屏幕与密钥轮换全流程。
创建 OAuth 2.0 客户端(五步)#
- 打开 [console.cloud.google.com](https://console.cloud.google.com) → 顶部选择/新建项目。
- 左侧「API 和服务 → OAuth 同意屏幕」:选择 External,填写应用名称与支持邮箱,保存。
- 「凭据 → 创建凭据 → OAuth 客户端 ID」:应用类型选 Web application。
- 「已获授权的重定向 URI」添加:
{BETTER_AUTH_URL}/api/auth/callback/google(本地即http://localhost:3000/api/auth/callback/google)。 - 复制生成的 Client ID 与 Client Secret 写入环境变量:
env.env.local(Google 段)
GOOGLE_CLIENT_ID=xxxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-...作用域与测试用户#
系统默认只请求基础资料作用域(openid email profile),无需敏感作用域审核即可上线。发布同意屏幕前,可将测试人员的 Gmail 加入「Test users」名单先行联调;点击「Publish App」后任何 Google 账号均可授权登录。
密钥轮换
在「凭据」页可随时重置 Client Secret;轮换后只需更新环境变量并重启服务,无需改动任何代码。同一 Google 项目可同时服务本地(localhost 回调)与生产(正式域名回调)两套客户端。
