[ 무물 ] Prisma ORM 으로 NextJS 백엔드 서버 구축하기

 

 🐙성향테스트 기반 AI 요금제 추천 서비스 , 무물 바로가기🐙

moo-mool

들어가며

프로젝트를 시작할 때 원래 구상은 백엔드는 Java Spring, 프론트엔드는 Next.js로 분리하는 방식이었습니다. 하지만 저희 팀은 모두 프론트엔드 개발자로, Java보다는 TypeScript 환경에 훨씬 익숙했습니다. 또, 이번 프로젝트는 AI를 활용해야 하는 명확한 요구사항이 있었기 때문에 백엔드의 고도화보다 프론트엔드 완성도와 사용자 경험을 더 중요한 목표로 두었습니다. 자연스럽게 개발 리소스를 최소화할 수 있는 방향을 찾게 되었습니다.
그러던 중 Next.js의 API Routes 기능을 활용하면 Node.js 기반으로 필요한 수준의 백엔드 API를 직접 작성할 수 있고, Prisma ORM을 통해 MYSQL 연동까지 가능하다는 점을 확인했습니다. 즉, NextJS 하나로 FE와 BE를 모두 커버할 수 있었습니다

---

NextAuth 사용한 이유

가장 먼저 해결해야 했던 과제가 카카오 로그인을 포함한 인증이었습니다. 인증은 직접 구현할 수도 있지만, OAuth 프로토콜 처리, 토큰 재발급, 세션 관리까지 전부 신경 쓰는 건 리스크와 비용이 컸습니다. 팀 리소스를 고려했을 때, 보안 로직을 직접 짜기보다는 검증된 라이브러리를 도입해 개발 속도를 높이고 안정성을 확보하는 게 더 합리적이었습니다.

 

 

1. 카카오 OAuth Provider 지원

// 카카오 OAuth 설정 - 커스텀 구현 없이 바로 적용
import KakaoProvider from "next-auth/providers/kakao"

별도 커스텀 없이 KakaoProvider를 불러와 바로 적용 가능해 초기 구축 속도를 단축할 수 있었습니다.

 

 

2. 세션 관리 간소화

// 한 줄로 사용자 정보 접근 가능
const { data: session } = useSession()

JWT 기반 세션을 기본 제공해 서버·클라이언트 어디서든 동일한 방식으로 접근할 수 있었습니다.
→ 로그인 → 사용자 정보 확인 → DB 저장 흐름이 일관성 있게 이어졌습니다.

 

 

3. 확장성

카카오 외에도 Google, Github 등 다양한 Provider를 쉽게 붙일 수 있어, 서비스 확장 시 로그인 채널을 늘리기 수월했습니다.

특히 카카오 로그인을 진행하고 사용자 정보에 접근하려고 할때

CONST {data: session} = useSession()

 

이렇게 단 한 줄만 작성하면 session 객체 안에서 로그인한 사용자 정보를 바로 활용할 수 있었습니다. 이는 직접 OAuth를 구현했을 때의 복잡한 토큰 파싱, API 호출 과정을 생략하고 한줄로 작성할 수 있어서 매우 편했습니다.

결국, Nextjs 풀스택 환경에서 인증레이어까지 자연스럽게 NextJS 생태계에 맞춰 해결할 수 있었습니다.

 

---

ORM : Prisma 선택

NextAuth로 인증을 해결한 뒤, 데이터 저장소로는 MySQL을 선택했습니다. MySQL은 가장 대중적이고 안정적인 관계형 DB였고, 저희 팀은 유레카 교육 과정에서 이미 Java + Spring + MySQL 조합을 경험한 적이 있어 빠르게 적응할 수 있었습니다.

다만 SQL을 직접 작성하는 방식은 협업과 유지보수에 불편함이 많았습니다. 그래서 ORM(Object Relational Mapping) 도구를 도입하기로 했고, 그중에서도 Prisma를 선택했습니다.

 

---

 

Java Spring과 Next.js비교

1. ORM 측면 : Java의 MyBatis vs. Next.js의 Prisma

타입 안전성 , 자동 마이그레이션

 

 

MyBatis는 SQL 중심의 Mapper 기반 ORM으로 개발자가 직접 SQL을 작성하고 이를 XML 혹은 annotation을 통해 객체와 매핑합니다.

// MyBatis + Spring 예시
@PostMapping
public ResponseEntity<String> createPost(@RequestBody PostDto postDto) {
    postService.createPost(postDto);
}

<!-- PostMapper.xml -->
<insert id="insertPost">
    INSERT INTO posts (title, content) VALUES (#{title}, #{content})
</insert>

 

이는 복잡한 쿼리나 DB에 특화된 로직을 세밀하게 제어가는데 강점이 있으며, 대규모 기업 시스템에서 선호하는 방식입니다. 다만, 쿼리 작성과 매핑 설정에 대한 개발자 의존도가 높아 생산성과 유지 보수 측면에서 부담이 있었습니다.

 

 

반면, Prisma는 코드 기반으로 스키마를 선언하고 이를 통해 타입 안전성과 자동 쿼리 생성을 지원하는 ORM으로, SQL 추상화 수준이 높고 타입스크립트와 자연스럽게 통합되며 데이터 모델링 및 마이그레이션이 효율적입니다. 

 

1. 타입 안전성

• Prisma는 TypeScript 통합을 통해 코드와 데이터베이스 스키마 간 타입 불일치 감소
• 컴파일 단계에서 오류 검증 가능

// prisma/schema.prisma
model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String
  createdAt DateTime @default(now())
}

 

2. 자동 마이그레이션 -> 빠른 개발 속도

• 데이터베이스 스키마 변경 시 자동으로 SQL 마이그레이션 생성하고 적용, 개발자가 수동으로 스키마를 업데이트하는 수고를 덜어줍니다.

 

3. 개발 효율성

• 간결한 API(prisma.user.findUnique, prisma.post.create 등)를 제공하여 반복적인 CRUD 코드를 단축시켜줍니다

// Next.js + Prisma 예시
const post = await prisma.post.create({
    data: { title, content },
});

 

이는 빠른 개발과 일관된 DB 구조 유지에 유리하며 팀의 TS 기반 프론트엔드 경험과도 잘 맞았습니다.

결과적으로 저희는 빠른 개발과 통합된 기술스택을 중심으로 Prisma ORM을 선택했습니다.

 

---

2. 아키텍처 비교 : Java의 MyBatis 계층형 vs. Prisma API 중심 구조

복잡한 계층을 최소화하고 엔드포인트 중심으로 빠르게 API를 구현할 수 있어, 초기 개발 속도와 협업 효율 향상

 

Java는 전형적인 계층형 아키텍처로 Controller -> Servie -> Repository 구조로 명확하게 역할을 분리합니다. 이는 대규모 시스템에 적합하며 테스트 유지보수 보안 측면에도 유리합니다. 그러나 초기 진입 장벽이 높고 간단한 기능 구현에도 코드가 분산되고 복잡해질 수 있습니다.

[Controller] → [Service] → [Mapper] → [DB]

 

반면, Nextjs의 API Route 구조는 라우팅과 로직이 파일단위로 묶여 있어, 엔드포인트 중심으로 구성됩니다. 복잡한 계층 없이도 간단한 API 기능을 빠르게 구현할 수 있으며, page/api/* 폴더 만으로 Rest API를 구성할 수 있다는 점도 장점입니다. 다만 규모가 커질수록 모듈화 설계나 미들웨어 구성이 필요합니다.

[API Route] → [Prisma Client] → [DB]

 

이러한 구조적 간결함은 프로젝트 초기에 장점으로 작용하였습니다.

 

---

게시글 작성 API 예제 비교

 

게시글을 작성하는 API를 각가 Java Spring과 Next로 구현해 Next Prisma의 구조적 단순함을 확인해보겠습니다.

 

Java Spring + MyBatis (계층형)

// PostController.java
@RestController
@RequestMapping("/api/posts")
public class PostController {
  private final PostService postService;
  public PostController(PostService postService) { this.postService = postService; }

  @PostMapping
  public ResponseEntity<PostDto> create(@RequestBody PostDto dto) {
    return ResponseEntity.ok(postService.create(dto));
  }
}

사용자가 /api/posts 로 POST 요청을 보내면 PostController 가 이를 받고, 실제 로직 처리를 위해 PostService로 전달합니다.

// PostService.java
@Service
public class PostService {
  private final PostMapper postMapper;
  public PostService(PostMapper postMapper) { this.postMapper = postMapper; }

  public PostDto create(PostDto dto) {
    postMapper.insertPost(dto);
    return dto;
  }
}

// PostMapper.java
@Mapper
public interface PostMapper {
  void insertPost(PostDto dto);
}

Mapper 인터페이스를 통해 실제 SQL을 실행하는 XML 파일과 연결합니다.

<!-- PostMapper.xml -->
<mapper namespace="com.example.PostMapper">
  <insert id="insertPost" parameterType="com.example.PostDto">
    INSERT INTO posts (title, content) VALUES (#{title}, #{content})
  </insert>
</mapper>

SQL 문이 Mapper 인터페이스와 매핑되어 실행됩니다.

// PostDto.java
@Data
public class PostDto {
  private String title;
  private String content;
}

데이터를 담는 DTO 객체

게시글 POST API 하나를 만들기 위해 총 5개의 계층적 파일이 필요합니다.

 

Nextjs (API Route + Prisma)

// prisma/schema.prisma
model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String
  createdAt DateTime @default(now())
}

// app/api/posts/route.ts (Next.js App Router)
import { NextResponse } from "next/server";
import { prisma } from "@/lib/prisma";

export async function POST(req: Request) {
  const { title, content } = await req.json();
  const post = await prisma.post.create({ data: { title, content } });
  return NextResponse.json(post, { status: 200 });
}

 

 

shema.prisma 파일 1개로 데이터 테이블을 정의하고, NextJS의 API Route 안에서 Prisma Client를 바로 호출해 비즈니스 로직과 엔드포인트를 동시에 작성할 수 있습니다.

 

---

마무리하며

Java Spring은 대규모 시스템 구축에 적합한 안정성과 확장성을 갖춘 프레인워크로, 견고한 아키텍처 설계가 필요한 환경에서 적합합니다.

반면, NextJS는 프론트엔드와 백엔드를 통합해 빠르고 간단하게 개발할 수 있고, TypeScript 기반의 Prisma ORM과의 조합을 통해 비교적 가벼운 서비스 구조에 적합한 생산성과 유연성의 장점이 있습니다.

 

즉, Nextjs + Prisma 조합은 제한된 리소스와 시간 내에서 안정적이고 확장 가능한 풀스택 애플리케이션을 구축할 수 있고, 프론트엔드 중심의 팀 구성으로 백엔드 복잡성을 최소화하면서도 필요한 기능을 빠르게 구현할 수 있다는 장점이 있어 선택하였습니다.

 

 

 

참고

Prisma란? 기업들의 사용 사례부터 적용 방법까지의 사용 종합 가이드 I 이랜서 블로그