如何使用Prisma/NextAuth获取Twitter screen_name解决字段缺失报错

• 技术栈：PostgreSQL + Prisma + NextAuth
• 需求：获取Twitter账号登录返回的screen_name（Twitter用户名）字段
• 初始User模型配置后运行触发字段缺失报错，报错信息如下：
  1. Argument username for data.screenname is missing.
  2. Argument username for data.username is missing.
  3. Argument username for data.screen_name is missing.

初始配置的schema.prisma中User模型代码：

model User {
  id            String    @id @default(cuid())
  name          String?

  screenname      String    @unique
  screen_name      String    @unique
  username      String    @unique

  email         String?   @unique
  password      String?
  emailVerified DateTime?
  image         String?
  accounts      Account[]
  sessions      Session[]
}

• 模型中定义的screenname、screen_name、username三个字段均为非空必填字段（未加?标记可选属性），且设置了唯一约束，但NextAuth默认Twitter登录逻辑不会自动给这三个字段传值，Prisma创建用户记录时检测到必填字段无值，直接抛出参数缺失错误。
• 三个字段语义重复，同时存储Twitter用户名属于冗余设计，易引发数据不一致问题。

1. 修正Prisma User模型 #

删除冗余的同义字段，仅保留一个字段用于存储Twitter的screen_name，并将该字段标记为可选，避免未获取到值时触发必填校验。修正后的模型代码如下：

model User {
  id            String    @id @default(cuid())
  name          String?
  // 存储Twitter返回的screen_name，标记为可选+唯一约束
  twitterScreenName String? @unique
  email         String?   @unique
  password      String?
  emailVerified DateTime?
  image         String?
  accounts      Account[]
  sessions      Session[]
}

修改完成后执行Prisma迁移命令，将模型变更同步到数据库：

npx prisma migrate dev --name fix_user_twitter_field

2. 配置NextAuth Twitter Provider的Profile回调 #

在NextAuth配置中，为Twitter登录提供者添加profile回调，将Twitter接口返回的screen_name字段映射到数据库对应字段，示例代码如下：

import NextAuth from "next-auth";
import TwitterProvider from "next-auth/providers/twitter";
import { PrismaAdapter } from "@next-auth/prisma-adapter";
import prisma from "@/lib/prisma"; // 替换为你项目中的Prisma实例路径

export default NextAuth({
  adapter: PrismaAdapter(prisma),
  providers: [
    TwitterProvider({
      clientId: process.env.TWITTER_CLIENT_ID,
      clientSecret: process.env.TWITTER_CLIENT_SECRET,
      // 若使用Twitter OAuth 2.0保留version配置，使用1.0a则删除该行
      version: "2.0",
      profile(profile) {
        // OAuth 2.0版本返回结构取profile.data.username，即对应screen_name
        // OAuth 1.0a版本直接取profile.screen_name即可
        return {
          id: profile.data.id,
          name: profile.data.name,
          email: profile.data.email,
          image: profile.data.profile_image_url,
          twitterScreenName: profile.data.username,
        };
      },
    }),
  ],
  // 其余secret、回调等配置保持原有逻辑即可
});

注意事项 #

• 若业务场景必须保留多个用户名字段，需要在上述profile回调中为所有非空字段赋值，否则依然会触发参数缺失报错，不推荐该冗余设计。
• 若之前已经执行过错误的模型迁移，需要先删除数据库中冗余的screenname、screen_name、username字段，再执行新的迁移。

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