eatthefrog

MongoDB 연결 옵션 Deprecation 경고 해결하기 본문

백엔드 노트

MongoDB 연결 옵션 Deprecation 경고 해결하기

eater_forg 2025. 12. 18. 12:22



문제 상황

npm start 이후, Node.js 애플리케이션에서 MongoDB에 연결할 때 다음과 같은 경고 메시지가 나타났다.

[MONGODB DRIVER] Warning: useNewUrlParser is a deprecated option:
useNewUrlParser has no effect since Node.js Driver version 4.0.0 and will be removed in the next major version

[MONGODB DRIVER] Warning: useUnifiedTopology is a deprecated option:
useUnifiedTopology has no effect since Node.js Driver version 4.0.0 and will be removed in the next major version

 

 

왜 이런 경고가 발생하나요?

MongoDB Node.js 드라이버의 버전 업데이트 과저에서 발새한 변화다.

 

1. MonoDB Driver 3.x 이전

- URL 파싱과 토폴로지 관리가 기본적으로 비할성화되어 있었다.

- 개발자들이 명시적으로 옵션을 설정해야 했다.

 

2. MongoDB Driver 3.x 시기

- useNewUrlParser: true와 useUnififedTopology: true 옵션을 명시적으로 추가해야 했다.

- 이 옵션들은 새로운 URL 파서와 통합된 토폴로지 기능을 활성화 했다.

 

3. MogoDB Driver 4.0.0이후

- 새로운 URL 파서와 통합된 토폴로지 관리가 기본값이 되었다.

 - 더 이상 이 옵션들을 명시할 필요가 없어졌다.

- 옵션을 명시해도 무시되며, 경고 메시지만 출력된다.

 

즉, 애플리케이션 동작에는 문제가 없으며, 깔끔한 터미널을 위해서 옵션 객체에서 해당 옵션들을 제거하는 것이 좋다.