mirabo01 님의 블로그

백엔드 MVC 패턴 이유 | 왜 쓰고 어디서 한계가 생길까

백엔드 구조를 설명할 때 MVC는 가장 먼저 등장하는 패턴 중 하나입니다.다만 실무에서는 종종 “컨트롤러, 서비스, 레포지토리로 나누는 구조” 정도로만 이해되고 끝나는 경우가 많습니다.원래 MVC는 요청 처리 흐름을 역할별로 나눠서, 코드의 책임을 분리하고 유지보수를 쉽게 만들기 위한 패턴입니다.웹 프레임워크에서는 이 개념이 서버 요청 처리 방식에 맞게 조금씩 변형되어 사용됩니다.예를 들어 Spring Web MVC는 DispatcherServlet을 중심으로 요청을 적절한 핸들러로 보내고, ASP.NET Core MVC 역시 라우팅을 통해 요청을 컨트롤러 액션에 연결하는 흐름을 기본으로 둡니다.즉, 백엔드에서 MVC는 단순히 파일을 나누는 규칙이 아니라, 요청을 받고 처리하고 응답하는 과정을 어떻게 역..

JWT 인증까지 구현했다면,이제 서버는 **“진짜 운영 환경을 전제로 한 단계”**로 넘어갈 준비가 됐다.그 핵심이 바로 PostgreSQL 연동과 스키마 관리(Migration) 다.이번 챕터에서는PostgreSQL을 Go 서버에 연결하는 기본 흐름database/sql 기준의 실무 설정Migration을 왜, 어떻게 관리하는지를 과하지 않게, 하지만 실무 기준으로 정리한다.왜 SQLite가 아니라 PostgreSQL인가이전 챕터에서는 구조 설명을 위해SQLite나 메모리 저장소를 사용했다.하지만 운영 환경에서는 대부분 다음 이유로 PostgreSQL을 선택한다.동시성 처리에 강함트랜잭션 안정성JSON, 인덱스, 확장 기능 풍부클라우드 환경과 궁합이 좋음즉,“Go 서버 실무”를 이야기하려면 Postgr..

트랜잭션까지 정리했다면,이제 서버 코드에서 마지막으로 꼭 잡아야 하는 기준이 남아 있다.바로 API 에러 응답 규약이다.에러 처리를 대충 넘기면 초반에는 편해 보이지만,운영 단계에 들어가면 다음 문제가 바로 터진다.프론트엔드에서 에러를 분기하기 어렵다로그에는 에러가 있는데, 클라이언트에는 의미 없는 메시지만 내려간다같은 에러인데 API마다 응답 형식이 다르다이번 챕터에서는Go + Gin 기반 API 서버에서 실무적으로 가장 많이 쓰는 에러 처리 기준을 정리한다.API 에러 처리의 목표부터 명확히 하자에러 처리는 “깔끔한 코드”를 위한 게 아니다.목표는 딱 세 가지다.클라이언트가 분기 처리할 수 있어야 하고운영자가 로그로 원인을 추적할 수 있어야 하며에러 표현이 서버 전체에서 일관되어야 한다이 세 가지를 ..

Gin으로 API 서버를 옮겼다면,다음으로 거의 반드시 등장하는 요구사항이 인증(Authentication)과 인가(Authorization) 다.이번 챕터에서는세션 기반이 아니라 JWT(Json Web Token) 를 사용하는 방식으로인증 흐름이 어떻게 구성되는지Gin 미들웨어로 어떻게 분리하는지실무에서 자주 실수하는 포인트는 무엇인지를 차분하게 정리한다.“완벽한 보안 구현”보다는API 서버에서 반복적으로 쓰이는 기본 설계를 이해하는 게 목표다.인증과 인가는 구분해서 생각해야 한다먼저 용어부터 정리하는 게 좋다.인증(Authentication): 너 누구냐인가(Authorization): 이 작업 해도 되냐JWT는 주로인증 결과를 토큰으로 전달하고이후 요청에서 인가 판단의 근거로 사용하는 데 쓰인다.왜..

이전 챕터에서net/http + handler / service / repository 구조로 CRUD API를 만들었다면,이번에는 그 구조를 Gin 프레임워크로 옮겨보는 단계다.이번 챕터의 핵심은 분명하다.Gin 문법을 많이 아는 것 ❌기존 구조를 깨지 않고 프레임워크만 교체 ⭕️즉,“Gin을 쓰면 코드 구조가 어떻게 달라지는가”가 아니라**“달라지지 않아야 하는 부분은 무엇인가”**에 초점을 둔다.왜 이 타이밍에 Gin을 보는가Gin은 Go 웹 프레임워크 중 가장 많이 사용된다.하지만 실무에서 Gin을 잘 쓰는 사람들의 공통점은 이거다.Gin 이전에 net/http 흐름을 한 번은 이해했다이 과정을 거치면Gin의 Context가 왜 필요한지미들웨어가 어디에 끼어드는지테스트를 어떻게 해야 하는지가 훨씬..

CRUD API까지 만들었다면,다음으로 자연스럽게 이어지는 주제는 DB 연동이다.이번 챕터에서는ORM을 바로 쓰지 않고, 표준 라이브러리 database/sql 을 기준으로DB 연결 흐름SQL 실행 방식Repository 패턴으로 구조를 정리하는 방법을 정리한다.목표는“편한 코드”가 아니라실무에서 오래 유지되는 구조를 한 번 만들어보는 것이다.왜 database/sql부터 다뤄야 할까Go에는 GORM 같은 ORM도 있고,sqlx 같은 헬퍼 라이브러리도 있다.그럼에도 불구하고database/sql을 먼저 다뤄보는 이유는 명확하다.모든 DB 라이브러리의 기반쿼리 실행 흐름이 명확함성능 특성을 직접 제어 가능문제가 생겼을 때 디버깅이 쉬움실무에서도“ORM을 쓰더라도 내부 동작은 database/sql”이라는 ..

이전 챕터에서라우팅 분리와 미들웨어 구조를 잡았다면,이제는 그 위에 실제로 동작하는 CRUD API를 올려볼 차례다.이번 챕터의 목표는 단순하다.REST 형태의 CRUD API를 한 번 직접 만들어보고비즈니스 로직과 HTTP 레이어를 분리하고그 구조를 테스트 코드로 검증해본다“완성도 높은 서비스”보다는실무에서 반복되는 기본 패턴을 익히는 데 초점을 둔다.예제 시나리오: User 관리 API예제로는 가장 단순한 User 리소스를 사용한다.POST /users 사용자 생성GET /users 사용자 목록 조회GET /users/{id} 사용자 단건 조회DB 대신메모리 저장소(in-memory store) 를 사용해구조에만 집중한다.기본 구조 다시 정리cmd/serve..

이전 챕터에서 net/http로 가장 단순한 API 서버를 만들었다면,이번에는 그 서버를 **조금 더 “실제 서비스에 가까운 형태”**로 확장해본다.이번 챕터의 핵심은 다음 두 가지다.라우팅 로직을 어떻게 정리하는가공통 로직을 미들웨어 형태로 어떻게 분리하는가프레임워크 없이도구조적으로 정리된 서버 코드를 만드는 게 목표다.왜 라우팅 분리가 필요한가단순 예제에서는 이런 코드가 문제 없어 보인다.http.HandleFunc("/ping", pingHandler)http.HandleFunc("/users", userHandler)http.HandleFunc("/orders", orderHandler)하지만 엔드포인트가 늘어나면 곧 한계가 온다.main 함수가 비대해짐핸들러 간 책임이 섞임테스트가 어려워짐그래서..

성능 분석까지 다뤘다면, 이제는지금까지 배운 내용을 실제 코드로 엮어보는 단계로 넘어가는 게 자연스럽다.이번 챕터에서는외부 프레임워크 없이 표준 라이브러리 net/http만 사용해서가장 기본적인 HTTP API 서버를 만들어본다.이 글의 목적은“화려한 기능”이 아니라,Go 서버 코드의 기본 뼈대가 어떻게 생겼는지를 이해하는 데 있다.왜 net/http부터 시작하는가Go 웹 개발을 검색하면Gin, Echo 같은 프레임워크가 먼저 등장한다.하지만 실무 기준으로 보면,프레임워크도 결국 net/http 위에 있음기본 구조를 모르면 디버깅이 어려움단순한 서비스에는 표준 라이브러리로도 충분이라는 이유로net/http를 한 번은 직접 써보는 게 좋다.가장 단순한 HTTP 서버package mainimport ( ..

성능 분석까지 다뤘다면, 이제는지금까지 배운 내용을 실제 코드로 엮어보는 단계로 넘어가는 게 자연스럽다.이번 챕터에서는외부 프레임워크 없이 표준 라이브러리 net/http만 사용해서가장 기본적인 HTTP API 서버를 만들어본다.이 글의 목적은“화려한 기능”이 아니라,Go 서버 코드의 기본 뼈대가 어떻게 생겼는지를 이해하는 데 있다.왜 net/http부터 시작하는가Go 웹 개발을 검색하면Gin, Echo 같은 프레임워크가 먼저 등장한다.하지만 실무 기준으로 보면,프레임워크도 결국 net/http 위에 있음기본 구조를 모르면 디버깅이 어려움단순한 서비스에는 표준 라이브러리로도 충분이라는 이유로net/http를 한 번은 직접 써보는 게 좋다.가장 단순한 HTTP 서버package mainimport ( ..