『 MongoDB Atlas 실전 연동 가이드 ④』 Node.js와 Mongoose로 MongoDB Atlas 연결하기

4강. Node.js와 Mongoose로 MongoDB Atlas 연결하기

이번 강의에서 다룰 내용

MongoDB Atlas에서 연결 문자열을 준비했으니, 이제 실제로 Node.js 백엔드 코드에서 클라우드 DB에 연결해봅니다. 이번 강의는 다음 단계로 구성됩니다.

• Node.js 프로젝트 생성 및 환경 설정
• mongoose 라이브러리 설치
• Atlas 연결 코드 작성
• 서버 실행 및 연결 확인

Node.js 프로젝트 초기 설정

1. 새 폴더 생성 후 터미널에서 초기화

mkdir mongo-atlas-test
cd mongo-atlas-test
npm init -y

1. 필수 패키지 설치

npm install express mongoose dotenv

• express: 웹 서버 프레임워크
• mongoose: MongoDB를 쉽게 다룰 수 있게 해주는 ODM
• dotenv: 환경변수로 DB 정보 분리할 때 사용
  
  

프로젝트 디렉토리 구조 예시

mongo-atlas-test/
├── server.js
├── db/
│   └── mongoose.js
├── .env

.env 파일 생성 (환경변수 설정)

// .env
MONGO_URI=mongodb+srv://testuser:test1234@cluster0.abcd123.mongodb.net/myDB?retryWrites=true&w=majority

※ 실제로 사용할 연결 문자열을 여기에 넣습니다.

MongoDB 연결 코드 작성

// db/mongoose.js
import mongoose from 'mongoose';
import dotenv from 'dotenv';

dotenv.config();

const connectDB = async () => {
  try {
    await mongoose.connect(process.env.MONGO_URI, {
      useNewUrlParser: true,
      useUnifiedTopology: true,
    });
    console.log(' MongoDB Atlas 연결 성공');
  } catch (err) {
    console.error(' MongoDB 연결 실패:', err.message);
  }
};

export default connectDB;

Express 서버 실행 코드 작성

// server.js
import express from 'express';
import connectDB from './db/mongoose.js';

const app = express();
connectDB();

app.get('/', (req, res) => {
  res.send('MongoDB Atlas 연결 테스트 중');
});

app.listen(3000, () => {
  console.log('http://localhost:3000 서버 실행 중');
});

실행하기

node server.js

터미널에 다음과 같은 로그가 출력되면 성공입니다:

MongoDB Atlas 연결 성공
http://localhost:3000 서버 실행 중

브라우저에서 http://localhost:3000 접속 → 정상 메시지 확인

단계 요약

• Node.js 프로젝트 생성 및 mongoose 설치
• .env를 통해 Atlas 연결 문자열 분리
• mongoose를 통해 MongoDB Atlas 연결 성공 확인
• Express 서버와 함께 기본 연동 완료
  
  

다음 5강에서는 mongoose를 활용해 실제로 데이터를 삽입하고 조회, 수정, 삭제하는 CRUD 실습을 진행합니다. 클라우드 DB와 연동된 백엔드에서 데이터를 다루는 기본 흐름을 익히게 됩니다.

 

💬 댓글

이번 글이 도움이 되었길 바랍니다. 궁금한 점이나 요청이 있다면 언제든 댓글로 남겨주세요. 댓글은 저에게 큰 힘이 됩니다. 다음 글도 기대해주세요.