NextAuth集成Google OAuth时Profile id缺失，自定义profile属性遇异常

核心问题 #

你遇到的情况既不是操作完全错误，也不是已知Bug，而是GoogleProvider的profile处理逻辑、Prisma模型配置和NextAuth会话回调三者没有配合到位：

1. 直接访问profile.role会报错，因为Google OAuth返回的用户数据里根本没有role字段，TypeScript也会因为默认GoogleProfile类型不包含该字段而报错。
2. 注释profile函数后功能正常但不添加角色，是因为NextAuth默认的profile处理不会注入role，且你没在会话回调里把角色同步到session中。

分步解决 #

1. 确保Prisma用户模型包含role字段

先检查你的Prisma schema，User模型必须有role字段（建议用枚举或默认值）：

model User {
  id            String    @id @default(cuid())
  name          String?
  email         String?   @unique
  emailVerified DateTime?
  image         String?
  role          String    @default("USER") // 或者用枚举类型：role Role @default(USER)
  accounts      Account[]
  sessions      Session[]
}

执行npx prisma migrate dev同步数据库结构。

2. 修正GoogleProvider的profile函数

不要尝试读取Google返回的profile.role（不存在），直接给默认角色，同时对齐TS类型：

GoogleProvider({
  clientId: process.env.GOOGLE_CLIENT_ID!,
  clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
  profile: (profile) => {
    return {
      id: profile.sub, // Google用户唯一标识
      name: profile.name,
      email: profile.email,
      image: profile.picture,
      role: "USER" // 直接设置默认角色
    };
  },
}),

3. 扩展NextAuth类型（解决TS错误）

在项目根目录创建types/next-auth.d.ts，扩展User和Session类型：

import NextAuth from "next-auth";

declare module "next-auth" {
  interface User {
    role: string;
  }

  interface Session {
    user: User;
  }
}

4. 配置会话回调，将角色同步到session

在authOptions中添加session策略和回调，确保角色能传递到前端会话：

export const authOptions: AuthOptions = {
  secret: process.env.NEXT_PUBLIC_SECRET!,
  providers: [/* 你的GoogleProvider配置 */],
  pages: {
    signIn: "/",
  },
  adapter: PrismaAdapter(prisma),
  // 新增以下配置
  session: {
    strategy: "jwt", // 用JWT策略才能在回调中修改会话数据
  },
  callbacks: {
    async jwt({ token, user }) {
      // 用户首次登录时，将user的role存入token
      if (user) token.role = user.role;
      return token;
    },
    async session({ session, token }) {
      // 将token中的role同步到session.user
      if (session.user) session.user.role = token.role as string;
      return session;
    },
  },
};

验证逻辑 #

完成以上配置后：

• 用户通过Google登录时，profile函数会给用户设置默认USER角色，Prisma适配器会将该角色存入数据库。
• 会话回调会把角色从JWT同步到session中，前端就能通过useSession()获取到用户角色。

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