Next.js+NextAuth.js 集成 Google OAuth 登录完整教程,含 Google Cloud Console 配置步骤、常见错误(redirect_uri_mismatch/access_denied)解决方案及 Vercel 部署踩坑记录,开发者快速实现谷歌一键登录必看。
🎯 项目背景
使用技术栈:Next.js 13 + NextAuth.js + Vercel 部署
需求:为 Web 应用添加 Google 一键登录功能,用户登录后自动创建账户并赠送积分。
📋 完整配置流程
第一步:Google Cloud Console 详细配置
这是整个流程的第一步,也是最容易出错的地方。很多开发者都是在这里踩坑的!
1. 创建 Google Cloud 项目
Step 1: 访问 Google Cloud Console
- 打开 Google Cloud Console
- 使用你的 Google 账号登录
Step 2: 创建新项目
- 点击顶部项目选择器
- 点击「新建项目」按钮
- 填写项目名称(如:my-nextjs-app)
- 选择组织(个人开发者可选择「无组织」)
- 点击「创建」
💡 小技巧:项目名称建议使用英文,避免后续配置时出现编码问题。
编辑
2. 启用 Google+ API(重要!)
很多人会忽略这一步,导致后面认证失败:
编辑
Step 1: 进入 API 库
- 在左侧菜单中找到「API 和服务」→「库」
- 或者直接搜索「Google+ API」
Step 2: 启用必要的 API
需要启用的 API:✅ Google+ API (已废弃,但某些功能仍需要)✅ People API (推荐使用,获取用户信息)✅ Gmail API (如果需要访问邮箱信息)
Step 3: 启用操作
- 点击每个 API 卡片
- 点击「启用」按钮
- 等待启用完成(通常几秒钟)
⚠️ 注意:如果不启用这些 API,后面会出现「access_denied」错误!
3. 配置 OAuth 同意屏幕(关键步骤)
这一步决定了用户看到的登录授权页面:
编辑
Step 1: 进入 OAuth 同意屏幕设置
- 左侧菜单:「API 和服务」→「OAuth 同意屏幕」
Step 2: 选择用户类型
继续阅读全文: Next.js+NextAuth.js接入Google Oauth登录