E11000重複キーエラーインデックス：Node.js、MongoDB、Mongoose開発におけるトラブルシューティング

2024-04-02

Node.js、MongoDB、MongooseにおけるE11000重複キーエラーインデックス

概要

原因

このエラーは、以下のいずれかの原因で発生します。

ユニーク制約違反: スキーマでunique: true オプションを指定したフィールドに、すでに同じ値を持つドキュメントが存在する場合。
複合インデックス違反: 複数のフィールドで構成される複合インデックスにおいて、すでに同じ値の組み合わせを持つドキュメントが存在する場合。

解決策

このエラーを解決するには、以下のいずれかの方法を試してください。

ドキュメントの修正

問題のドキュメントのキー値を変更し、重複しないようにします。

スキーマの修正

unique: true オプションを削除するか、複合インデックスの構成を変更します。

エラーハンドリング

エラーが発生しても処理を続行したい場合は、エラーハンドリングコードを実装します。

例

ユニーク制約違反

const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
  name: {
    type: String,
    unique: true,
    required: true,
  },
});

const User = mongoose.model('User', userSchema);

// エラーが発生する
const user = new User({ name: 'John Doe' });
await user.save();

// エラーハンドリング
try {
  await user.save();
} catch (err) {
  if (err.code === 11000) {
    // 重複キーエラー処理
  } else {
    // その他のエラー処理
  }
}

複合インデックス違反

const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
  name: {
    type: String,
    required: true,
  },
  email: {
    type: String,
    required: true,
  },
});

// 複合インデックスを作成
userSchema.index({ name: 1, email: 1 }, { unique: true });

const User = mongoose.model('User', userSchema);

// エラーが発生する
const user1 = new User({ name: 'John Doe', email: '[email protected]' });
const user2 = new User({ name: 'John Doe', email: '[email protected]' });
await user1.save();
await user2.save();

// エラーハンドリング
try {
  await user2.save();
} catch (err) {
  if (err.code === 11000) {
    // 重複キーエラー処理
  } else {
    // その他のエラー処理
  }
}

ユニーク制約違反

const mongoose = require('mongoose');

// スキーマ定義
const userSchema = new mongoose.Schema({
  name: {
    type: String,
    unique: true, // name フィールドはユニーク
    required: true,
  },
});

// モデル作成
const User = mongoose.model('User', userSchema);

// ドキュメント作成
const user1 = new User({ name: 'John Doe' });
const user2 = new User({ name: 'John Doe' }); // 同名のユーザー

// 保存処理
// user1 は保存成功
await user1.save();

// user2 は重複エラー発生
try {
  await user2.save();
} catch (err) {
  if (err.code === 11000) {
    console.error('重複キーエラー:', err.message);
  } else {
    console.error('予期せぬエラー:', err.message);
  }
}

複合インデックス違反

const mongoose = require('mongoose');

// スキーマ定義
const userSchema = new mongoose.Schema({
  name: {
    type: String,
    required: true,
  },
  email: {
    type: String,
    required: true,
  },
});

// 複合インデックス作成
userSchema.index({ name: 1, email: 1 }, { unique: true });

// モデル作成
const User = mongoose.model('User', userSchema);

// ドキュメント作成
const user1 = new User({ name: 'John Doe', email: '[email protected]' });
const user2 = new User({ name: 'John Doe', email: '[email protected]' }); // 同名・同メールアドレスのユーザー

// 保存処理
// user1 は保存成功
await user1.save();

// user2 は重複エラー発生
try {
  await user2.save();
} catch (err) {
  if (err.code === 11000) {
    console.error('重複キーエラー:', err.message);
  } else {
    console.error('予期せぬエラー:', err.message);
  }
}

エラーハンドリング

const mongoose = require('mongoose');

// スキーマ定義
const userSchema = new mongoose.Schema({
  name: {
    type: String,
    unique: true,
    required: true,
  },
});

// モデル作成
const User = mongoose.model('User', userSchema);

// 保存処理
async function saveUser(name) {
  const user = new User({ name });

  try {
    await user.save();
  } catch (err) {
    if (err.code === 11000) {
      // 重複キーエラー処理
      console.error('重複キーエラー:', err.message);
    } else {
      // その他のエラー処理
      console.error('予期せぬエラー:', err.message);
    }
  }
}

// 例
saveUser('John Doe');