如何使用next-auth将MongoDB中现有用户账号与Google OAuth账号绑定

OAuthAccountNotLinked报错的核心原因：next-auth默认逻辑下，OAuth登录返回的邮箱已存在用户记录，但该用户未绑定对应第三方OAuth账号时，就会抛出该错误，避免账号被恶意绑定。

你可以通过修改next-auth配置的signIn回调，手动处理同邮箱用户的OAuth绑定逻辑，具体修改如下：

1. 调整signIn回调实现自动绑定 #

在signIn回调中新增Google账号的匹配逻辑，查询数据库中是否存在同邮箱的已有用户，存在则手动创建OAuth关联记录，复用原有用户数据：

// 先引入你的MongoDB连接工具，可替换为你项目中已有的数据库查询方法
import { getMongoClient } from '/path/to/your/db-utils'

const options = {
  // 保留你原有providers、pages、database等配置不变
  callbacks: {
    signIn: async (user, account, profile) => {
      // 仅处理Google OAuth登录场景
      if (account.provider === 'google') {
        const db = await getMongoClient()
        // 用Google返回的邮箱匹配已有用户
        const existingUser = await db.collection('users').findOne({ email: profile.email })

        if (existingUser) {
          // 检查该用户是否已经绑定过当前Google账号
          const linkedAccount = await db.collection('accounts').findOne({
            userId: existingUser._id,
            provider: 'google',
            providerAccountId: account.providerAccountId
          })

          // 未绑定则手动插入关联记录
          if (!linkedAccount) {
            await db.collection('accounts').insertOne({
              userId: existingUser._id,
              provider: 'google',
              providerAccountId: account.providerAccountId,
              access_token: account.access_token,
              expires_at: account.expires_at,
              id_token: account.id_token,
              scope: account.scope,
              token_type: account.token_type,
              type: account.type
            })
          }

          // 替换user对象的id为原有用户id，后续回调将复用原有用户信息
          user.id = existingUser._id
          user.email = existingUser.email
          user.status = existingUser.status
          return true
        }
      }
      // 其他登录场景走默认逻辑
      return true
    },
    // 同步修改jwt回调，兼容两种登录方式的用户信息写入
    async jwt(token, user, account, profile, isNewUser) {
      if (user) {
        token.user = { 
          _id: user._id || user.id, 
          email: user.email, 
          status: user.status, 
          provider: account?.provider || 'credentials' 
        }
      }
      return token
    },
    // 保留你原有redirect、session回调不变
  }
}

2. 额外配置注意事项 #

• 你当前配置中synchronize: true仅建议在开发环境开启，生产环境需改为false，避免自动修改数据库结构导致数据丢失
• 可新增邮箱校验逻辑，在绑定前判断profile.email_verified是否为true，避免恶意用户用未验证的Google邮箱绑定他人账号
• 如果你升级到next-auth v4版本，signIn回调的参数会改为单个对象，需调整为async ({ user, account, profile }) => {}的写法

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