使用NextAuth搭配MongoDB时出现重复键错误问题排查

核心原因定位 #

userId为null的本质是NextAuth在创建用户时，没有正确从登录提供商获取或映射用户的唯一标识ID，导致插入MongoDB时userId字段为空；而userId_1是唯一索引，多个null值违反唯一性约束，触发报错。

分步解决方案 #

1. 修正NextAuth的Profile回调，确保获取用户唯一ID #

检查[...nextauth].ts中的profile回调函数，确认正确提取登录提供商返回的用户唯一ID（不同提供商字段名可能不同：Google用sub，GitHub用id），并返回给NextAuth作为用户的id字段：

import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";
import GitHubProvider from "next-auth/providers/github";

export default NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
    }),
    GitHubProvider({
      clientId: process.env.GITHUB_CLIENT_ID,
      clientSecret: process.env.GITHUB_CLIENT_SECRET,
    }),
  ],
  callbacks: {
    async profile(profile, { provider }) {
      // 根据提供商类型适配ID字段
      const userId = provider === "google" ? profile.sub : profile.id;
      return {
        id: userId, // 必须返回唯一ID，NextAuth会用这个值填充MongoDB的userId
        name: profile.name || profile.login,
        email: profile.email,
        image: profile.picture || profile.avatar_url,
      };
    },
  },
  // 其他配置...
});

2. 调整MongoDB的唯一索引规则 #

如果暂时无法修复代码中的ID映射问题，可以修改userId_1索引，避免null值触发重复键错误：

• 方式一：删除原唯一索引（临时应急）

  // 在MongoDB Shell或可视化工具中执行
  db.users.dropIndex("userId_1");
  

• 方式二：创建稀疏唯一索引（忽略null值文档）

  db.users.createIndex({ userId: 1 }, { unique: true, sparse: true });
  

  稀疏索引只会对存在userId字段的文档做唯一性校验，不会限制null值的重复。

3. 检查NextAuth Adapter的配置 #

如果使用了自定义MongoDB Adapter，确认Adapter逻辑中没有错误覆盖或遗漏userId字段的赋值。官方MongoDB Adapter会自动将NextAuth返回的id写入userId字段，若自定义了Adapter，需确保对应逻辑正确。

4. 排查自定义用户创建逻辑 #

检查是否有其他业务代码（如登录钩子、用户同步脚本）在插入用户时，未设置userId就直接写入数据库，这类逻辑会绕过NextAuth的正常流程导致null值。

为什么重置模型/删库/换提供商无效？ #

• 重置模型/删库只会清除现有数据，但每次登录时新的用户文档仍会被插入，若userId依旧为null，会再次触发唯一索引冲突；
• 换提供商无效说明问题不在提供商本身，而是你的代码未正确适配不同提供商的用户ID字段，导致无论用哪个提供商，都无法获取到有效的userId。

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