如何在authjs中通过OAuth（Google Provider）获取持久化用户唯一ID？

核心原理 #

Google OAuth Provider返回的用户信息中，sub字段是Google分配给用户的永久唯一标识符，这个值不会随登录会话变更，完全可以用来关联你的数据库用户数据。Auth.js默认会获取这个字段，你只需要把它传递到会话中即可。

具体实现步骤 #

1. 在Auth.js配置中传递sub到会话
   修改你的[...nextauth].js（或.ts）文件中的callbacks配置，在jwt回调里保留sub，并在session回调里把它添加到会话对象中：

   export const authOptions = {
     providers: [
       GoogleProvider({
         clientId: process.env.GOOGLE_CLIENT_ID,
         clientSecret: process.env.GOOGLE_CLIENT_SECRET,
       }),
     ],
     callbacks: {
       async jwt({ token, user }) {
         // 用户首次登录时，user对象包含Google返回的所有信息，包括sub
         if (user) {
           token.sub = user.sub;
         }
         return token;
       },
       async session({ session, token }) {
         // 将sub添加到会话中，前端和后端都能访问
         session.user.id = token.sub;
         return session;
       },
     },
   };
   

2. 数据库关联逻辑

   • 用户首次登录时，从user对象（在jwt或signIn回调中）获取sub，创建新的数据库用户记录，把sub作为唯一标识字段存储。
   • 后续登录时，通过sub查询数据库，匹配对应的用户数据，实现持久化关联。

验证方式 #

登录后，在前端通过useSession钩子获取会话，就能拿到session.user.id（即Google的sub值），这个值每次登录都不会变化，可安全用于数据库关联。

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