Next.js中Next-auth的Google Provider不再返回用户头像求助

1. 检查Google Provider的Profile回调配置 #

Google OAuth返回的用户头像是picture字段，而非Next-auth默认映射的image，需要在Provider配置里手动做字段映射：

// [...nextauth].js/ts
import GoogleProvider from "next-auth/providers/google";

export default NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
      // 新增或确认profile回调逻辑
      profile(profile) {
        return {
          id: profile.sub,
          name: profile.name,
          email: profile.email,
          image: profile.picture, // 明确将Google返回的picture映射为image
        };
      },
    }),
  ],
  // 其他配置项...
});

2. 确认Prisma Schema的User模型定义 #

检查schema.prisma中User模型的image字段是否配置正确：

model User {
  id            String    @id @default(cuid())
  name          String?
  email         String    @unique
  emailVerified DateTime?
  image         String? // 确保为可选String类型，可接收并存储头像地址
  // 其余字段...
}

如果近期修改过字段定义，需执行npx prisma migrate dev同步数据库结构。

3. 检查Next-auth的Session回调配置 #

确保session回调中正确将数据库用户的image字段返回给前端：

export default NextAuth({
  // ...其他配置
  callbacks: {
    async session({ session, user }) {
      // 把数据库中存储的用户头像赋值给session对象
      session.user.image = user.image;
      return session;
    },
  },
});

4. 手动验证Google用户信息接口 #

用登录后获取的access_token调用Google官方接口，确认是否能拿到头像数据：

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://www.googleapis.com/oauth2/v3/userinfo

如果返回结果中没有picture字段，要么是用户Google账号未设置头像，要么是授权流程中存在隐性权限问题（可尝试重新登录时强制触发授权确认）。

5. 清除会话缓存 #

删除项目根目录下的.next文件夹，重启开发服务器，清除旧的会话缓存数据。

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