Next.js+NextAuth.js接入Google Oauth登录

261 阅读2分钟

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)
  • 选择组织(个人开发者可选择「无组织」)
  • 点击「创建」

💡 小技巧:项目名称建议使用英文,避免后续配置时出现编码问题。

Next.js+NextAuth.js 接入 Google Oauth 登录

编辑

2. 启用 Google+ API(重要!)

很多人会忽略这一步,导致后面认证失败:

Next.js+NextAuth.js 接入 Google Oauth 登录

编辑

Step 1: 进入 API 库

  • 在左侧菜单中找到「API 和服务」→「库」
  • 或者直接搜索「Google+ API」

Step 2: 启用必要的 API

需要启用的 API:✅ Google+ API (已废弃,但某些功能仍需要)✅ People API (推荐使用,获取用户信息)✅ Gmail API (如果需要访问邮箱信息)

Step 3: 启用操作

  • 点击每个 API 卡片
  • 点击「启用」按钮
  • 等待启用完成(通常几秒钟)

⚠️ 注意:如果不启用这些 API,后面会出现「access_denied」错误!

3. 配置 OAuth 同意屏幕(关键步骤)

这一步决定了用户看到的登录授权页面:

Next.js+NextAuth.js 接入 Google Oauth 登录

编辑

Step 1: 进入 OAuth 同意屏幕设置

  • 左侧菜单:「API 和服务」→「OAuth 同意屏幕」

Step 2: 选择用户类型

继续阅读全文: Next.js+NextAuth.js接入Google Oauth登录