✅ Prisma + REST API 통합 가이드 – Express 기반 실전 예제

 

✅ Prisma + REST API 통합 가이드 – Express 기반 실전 예제

"Prisma로 타입 안정성과 생산성을 모두 잡고, Express로 REST API를 구축하자."
NestJS든 Express든 Prisma는 완벽하게 통합됩니다.

---

🎯 목표

• Express 기반 REST API 서버에 Prisma ORM을 도입
• 사용자(User) 생성 및 조회 API 구현
• TypeScript + PostgreSQL + Prisma 조합

---

📦 1. 프로젝트 기본 세팅

mkdir prisma-rest-api && cd prisma-rest-api
npm init -y
npm install express @prisma/client
npm install prisma --save-dev
npm install typescript ts-node @types/node @types/express --save-dev

tsconfig.json 생성:

{
  "compilerOptions": {
    "target": "es2019",
    "module": "commonjs",
    "strict": true,
    "outDir": "dist",
    "esModuleInterop": true
  },
  "include": ["src"]
}

---

📐 2. Prisma 설정 및 DB 모델 정의

npx prisma init

.env 설정:

DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

prisma/schema.prisma:

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id    Int    @id @default(autoincrement())
  name  String
  email String @unique
}

마이그레이션 적용:

npx prisma migrate dev --name init

---

🔧 3. Express API 작성

반응형

src/prisma.ts – Prisma Client 인스턴스

import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
export default prisma

---

src/server.ts – 서버 및 라우터 설정

import express from 'express'
import prisma from './prisma'

const app = express()
app.use(express.json())

// 사용자 생성
app.post('/users', async (req, res) => {
  const { name, email } = req.body
  const user = await prisma.user.create({
    data: { name, email },
  })
  res.json(user)
})

// 사용자 목록
app.get('/users', async (_req, res) => {
  const users = await prisma.user.findMany()
  res.json(users)
})

app.listen(3000, () => {
  console.log('🚀 Server running on http://localhost:3000')
})

---

▶️ 실행

npx ts-node src/server.ts

• POST http://localhost:3000/users
• { "name": "훈창", "email": "hoon@example.com" }
• GET http://localhost:3000/users
  → 사용자 목록 반환

---

✅ Prisma + REST API 연동 핵심 요약

항목 내용

Client 생성	new PrismaClient() 사용
타입 자동완성	.user.findMany() 등 완벽한 IntelliSense
마이그레이션	prisma migrate dev 로 관리
실무 적용	Express / NestJS / Fastify 등 자유롭게 연동 가능

---

🧠 실무 팁

• Prisma Client는 앱 전체에서 싱글톤으로 관리하는 것이 안정적
• prisma.$disconnect()는 서버 종료 시 명시적으로 호출 필요
• CRUD 외에도 .count(), .aggregate(), .transaction() 등 확장 기능 풍부

---

 

Prisma REST API,Prisma Express 연동,TypeScript Express Prisma,Prisma PostgreSQL 예제,Node.js ORM REST,Prisma로 CRUD 만들기,REST API ORM 통합,Prisma 서버 구축,Prisma Client 사용법,Prisma 실무 예제

---