next-auth搭配Google OAuth及自有数据库用户的正确使用方法是什么？

1. 认证后读写数据库的逻辑位置 #

你在Passport中实现的用户查询、创建逻辑，直接写在NextAuth配置文件的signIn回调中即可。
NextAuth配置文件的默认路径：

• Pages Router：pages/api/auth/[...nextauth].js
• App Router：app/api/auth/[...nextauth]/route.js
  完整参考配置如下：

import NextAuth from "next-auth"
import GoogleProvider from "next-auth/providers/google"
// 引入你自己的数据库用户模型，支持Mongoose/Prism/等任意数据库操作工具
import Profile from "../../../models/Profile"

export default NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
    }),
  ],
  session: {
    // 明确指定session使用JWT策略，无自定义适配器时默认就是该值
    strategy: "jwt"
  },
  callbacks: {
    // 对应Passport的验证回调逻辑，谷歌认证完成后自动触发
    async signIn({ profile }) {
      // profile为谷歌返回的原始用户信息，和Passport中拿到的结构基本一致
      const existingProfile = await Profile.findOne({ email: profile.email })
      
      // 已有用户直接挂载数据库数据到返回对象
      if (existingProfile) {
        profile.dbUser = existingProfile
        return true
      }

      // 新用户创建数据库记录
      const newProfile = await Profile.create({
        googleId: profile.sub, // 谷歌用户唯一标识对应profile.sub字段
        email: profile.email,
        // 此处可添加你需要存储的任意自定义字段
      })
      profile.dbUser = newProfile
      return true
    },

    // JWT回调：登录时将自定义数据写入加密token
    async jwt({ token, profile }) {
      if (profile?.dbUser) {
        token.dbUser = profile.dbUser
      }
      return token
    },

    // Session回调：将token中的自定义数据注入返回给前端的session对象
    async session({ session, token }) {
      // 直接覆盖默认的user字段，替换为你数据库中的用户数据
      session.user = token.dbUser
      return session
    }
  }
})

2. 默认Session字段说明与自定义方案 #

你看到的name/email/image是NextAuth对所有OAuth提供商返回的用户信息做的标准化封装，目的是统一不同第三方登录的返回结构，降低通用适配成本。
按照上面的示例配置jwt和session回调后，前端调用useSession()拿到的session.user就会直接返回你数据库中存储的自定义用户数据，不需要再处理默认字段。

注意事项 #

• 所有回调函数都必须返回处理后的对象，否则会出现数据丢失
• 如果使用数据库session策略而非JWT策略，只需配置自定义适配器即可自动完成用户读写，不需要手动实现signIn回调逻辑

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