When a Single create() Call Becomes Two Writes: A Mongo + Mongoose Gotcha 😨

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

웹 개발

대상자

MongoDB와 Mongoose를 사용하는 백엔드 개발자, 특히 문서 생성 로직을 구현하는 개발자

핵심 요약

• Mongoose의 Model.create() 메서드는 인자로 문서 배열을 받는 것으로 설계되어 있어, { session }과 같은 옵션을 잘못 전달하면 2개의 문서가 삽입될 수 있다
• insertMany()를 사용하여 배열 형태로 문서를 전달하면 옵션을 올바르게 해석할 수 있으나, 반환값은 배열 형태가 된다
• 단일 문서 삽입은 .save() 메서드를 사용하는 것이 적절하며, 이 메서드는 항상 단일 문서를 반환

섹션별 세부 요약

1. 문제 발생 원인

• Mongoose의 Model.create() 메서드는 기본적으로 다중 문서 삽입을 지원하며, doc1, doc2, ... 형태로 인자를 받는다
• { session }과 같은 옵션을 개별 인자로 전달하면 Mongoose가 해당 객체를 새로운 문서로 인식하여 삽입
• mongoose.set('debug', true)를 활성화하면 insertOne 명령이 2회 실행되는 것을 확인할 수 있음

2. 임시 해결 방법

• insertMany()를 사용하여 문서 배열로 전달하면 옵션을 올바르게 해석

```javascript

await tagModel.create([ { name, color, user, parent } ], { session });

```

• 이 방법은 단일 문서 삽입 시 배열 형태로 반환하여 사용자 측면에서 불편함을 유발

3. 권장 솔루션

• 단일 문서 삽입은 .save() 메서드를 사용

```javascript

const doc = new tagModel({ name, color, user, parent });

await doc.save({ session });

return doc;

```

• .save()는 옵션을 올바르게 해석하고, 항상 단일 문서를 반환
• Model.insertMany()는 대량 삽입에 최적화되어 있음

결론

• 단일 문서 삽입은 .save() 메서드를, 대량 삽입은 insertMany()를 사용
• Model.create() 사용 시 인자 형태를 명확히 구분하여 옵션과 문서를 혼동하지 않도록 주의
• mongoose.set('debug', true)를 활성화하여 로그를 통해 명령문을 실시간으로 확인하여 문제를 빠르게 진단 가능