https://lameld.github.io/nestjs/Recent content in NestJS on LaMelDHugoko-KRThu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-01/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-01/<h2 id="11-nodejs">1.1. <code>Node.js</code></h2> <h3 id="111-단일-스레드에서-구동되는-논블로킹-io-이벤트-기반-비동기-방식">1.1.1. 단일 스레드에서 구동되는 논블로킹 I/O 이벤트 기반 비동기 방식</h3> <ul> <li>멀티스레딩 <ul> <li>여러 작업 요청이 한꺼번에 들어올 때, 각 작업을 처리하기 위한 스레드를 만들고 할당하는 방식</li> <li>속도가 빠르다.</li> <li>공유 자원의 관리가 힘들다.</li> <li>스레드가 늘어남에 따라 메모리를 소모하여 메모리 관리가 중요하다.</li> </ul> </li> <li><code>Node.js</code> <ul> <li>어플리케이션 단에서는 단일 스레드에서 작업을 처리</li> <li>백그라운드에서는 스레드 풀을 구성해 작업을 처리</li> <li>웹 서버를 운용할 때는 CPU 코어를 순산해서 관리하므로 실제 작업은 여러 개의 코어에서 별개로 처리</li> <li>들어온 작업을 앞의 작업이 끝날 때까지 기다리지 않고(non-blocking) 비동기로 처리</li> <li>입력은 하나의 스레드에서 받지만 순서대로 처리하지 않고 먼저 처리된 결과를 이벤트로 반환해주는 방식 사용</li> </ul> </li> </ul> <h2 id="12-이벤트-루프">1.2. 이벤트 루프</h2> <ul> <li>이벤트 루프는 시스템 커널에서 가능한 작업이 있다면 그 작업을 커널에 이관한다.</li> <li><code>Javascript</code>가 단일 스레드 임에도 불구하고 <code>Node.js</code>가 논블로킹 I/O 작업을 수행할 수 있도록 해주는 핵심 기능이다.</li> <li>이벤트 루프의 6 단계 <ol> <li>타이머 단계</li> <li>대기 콜백 단계</li> <li>유휴, 준비 단계</li> <li>폴 단계 - 수신: 연결, 데이터 등</li> <li>체크 단계</li> <li>종료 콜백 단계</li> </ol> </li> </ul> <h3 id="121-타이머-단계">1.2.1. 타이머 단계</h3> <ul> <li>타이머 단계의 큐에는 <code>setTimeout</code>이나 <code>setInterval</code>과 같은 함수를 통해 만들어진 타이머들을 큐에 넣고 실행한다.</li> <li><code>now - registeredTime ≥ delta</code>인 타이머들이 큐에 들어간다.</li> <li><code>delta</code>는 <code>setTimeout(() =&gt; {}, delta)</code>와 같이 타이머가 등록된 시각에 얼만큼 시간이 흐른 후 동작해야 하는지를 나타내는 값이다.</li> </ul> <h3 id="122-대기-콜백-단계pending-callback-phase">1.2.2. 대기 콜백 단계(pending callback phase)</h3> <ul> <li>대기 단계의 큐에 들어 있는 콜백들은 현재 돌고 있는 루프 이전의 작업에서 큐에 들어온 콜백이다.</li> <li>TCP 핸들러 내에서 비동기의 쓰기 작업을 한다면, TCP 통신과 쓰기 작업이 끝난 후 해당 작업의 콜백이 큐에 들어간다. 또 에러 핸들러 콜백도 큐로 들어오게 된다.</li> <li>타이머 단계를 거쳐 대기 콜백 단계에 들어오면, 이전 작업들의 콜백이 <code>pending_queue</code>에서 대기 중인지 검사한다. 만약 실행 대기 중이라면 시스템 실행 한도에 도달할 때까지 꺼내어 실행한다.</li> </ul> <h3 id="123-유휴-준비-단계idle-prepare-phase">1.2.3. 유휴, 준비 단계(idle, prepare phase)</h3> <ul> <li>유휴 단계는 틱마다 실행된다.</li> <li>준비 단계는 매 폴링 직전에 실행된다.</li> <li><code>Node.js</code>의 내부 동작을 위한 것이라고만 알고 있자.</li> </ul> <h3 id="124-폴-단계poll-phase">1.2.4. 폴 단계(poll phase)</h3> <ul> <li>폴 단계에서는 새로운 I/O 이벤트를 가져와서 관련 콜백을 수행한다.</li> <li>소켓 연결과 같은 새로운 커넥션을 맺거나 파일 읽기와 같이 데이터 처리를 받아들이게 된다.</li> <li><code>watch_queue</code>를 갖고 있다.</li> <li><code>watch_queue</code>가 비어 있지 않다면 큐가 비거나 시스템 실행 한도에 다다를 때까지 동기적으로 모든 콜백을 실행한다.</li> <li>큐가 비게 되면 <code>Node.js</code>는 곷바로 다음 단계를 이동하지 않고 <code>check_queue</code>, <code>pending_queue</code>, <code>closing_callback_queue</code>에 남은 작업이 있는지 검사한 다음 작업이 있다면 다음 단계로 이동한다.</li> <li>큐가 모두 비어서 해야할 작업이 없다면 잠시 대기를 하게 된다. <ul> <li>타이머 최소 힙의 첫 번째 타이머를 꺼내어 지금 실행할 수 있는 상태라면 그 시간만큼 대기한 후 다음 단계로 이동한다.</li> <li>바로 타이머 단계로 넘어간다고 해도 어차피 첫 번째 타이머를 수행할 시간이 되지 않았기 때문에 이벤트 루프를 한 번 더 돌아야 하기 때문이다.</li> </ul> </li> </ul> <h3 id="125-체크-단계check-phase">1.2.5. 체크 단계(check phase)</h3> <ul> <li><code>setImmediate</code>의 콜백만을 위한 단계</li> <li>큐가 비거나 시스템 실행 한도에 도달할 때까지 콜백을 수행</li> </ul> <h3 id="126-종료-콜백-단계close-callback-phase">1.2.6. 종료 콜백 단계(close callback phase)</h3> <ul> <li> <p><code>socket.on('close', () =&gt; {})</code>과 같은 close나 destroy 이벤트 타입의 콜백이 처리된다.</p>https://lameld.github.io/nestjs/ch-02/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-02/<blockquote> <p><strong>인터페이스 계층</strong>은 들어오는 HTTP 요청을 받아 결과를 응답하는 진입점이다. NestJS 에서는 <strong>컨트롤러(Controller)</strong> 가 라우팅을 맡아 이 역할을 한다.</p>https://lameld.github.io/nestjs/ch-03/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-03/<blockquote> <p><strong>프로바이더(Provider)</strong> 는 비즈니스 로직을 담는 클래스로, NestJS의 <strong>의존성 주입(DI)</strong> 을 통해 다른 곳에 주입된다. 대표적으로 <strong>서비스(Service)</strong> 가 프로바이더다.</p>https://lameld.github.io/nestjs/ch-04/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-04/<blockquote> <p><strong>모듈(Module)</strong> 은 관련된 컨트롤러·프로바이더를 하나로 묶는 단위다. 앱은 루트 모듈(<code>AppModule</code>)에서 시작해 기능별 모듈로 뻗어 나간다.</p>https://lameld.github.io/nestjs/ch-05/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-05/<blockquote> <p>설정값(DB 접속, 시크릿 등)은 코드에 하드코딩하지 않고 <strong>환경 변수</strong>로 분리한다. NestJS는 <code>@nestjs/config</code> 로 <code>.env</code> 를 읽어 <code>ConfigService</code> 로 제공한다.</p>https://lameld.github.io/nestjs/ch-06/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-06/<blockquote> <p><strong>파이프(Pipe)</strong> 는 컨트롤러 핸들러에 도달하기 전에 입력값을 <strong>변환</strong>하거나 <strong>검증</strong>한다. 잘못된 입력은 여기서 걸러 예외로 응답한다.</p>https://lameld.github.io/nestjs/ch-07/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-07/<blockquote> <p><strong>영속화(Persistence)</strong> 는 데이터를 DB에 저장·조회하는 계층이다. NestJS는 주로 <strong>TypeORM</strong>(또는 Prisma)과 연동하며 리포지토리 패턴으로 접근한다.</p>https://lameld.github.io/nestjs/ch-08/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-08/<blockquote> <p><strong>미들웨어(Middleware)</strong> 는 라우트 핸들러 <strong>이전</strong>에 실행되는 함수다. 요청·응답 객체에 접근해 로깅·인증 전처리·CORS 등을 처리한다. (Express 미들웨어와 동일 개념)</p>https://lameld.github.io/nestjs/ch-09/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-09/<blockquote> <p><strong>인증(Authentication)</strong> 은 &ldquo;누구인지&rdquo; 확인, <strong>인가(Authorization)</strong> 는 &ldquo;무엇을 할 수 있는지&rdquo; 확인이다. NestJS는 <strong>Passport</strong> + <strong>JWT</strong> 조합을 주로 쓴다.</p>https://lameld.github.io/nestjs/ch-10/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-10/<blockquote> <p><strong>로깅</strong>은 앱의 동작·오류를 기록해 문제를 추적한다. NestJS는 내장 <code>Logger</code> 를 제공하며, 운영에서는 <code>winston</code> 같은 전용 로거로 교체한다.</p>https://lameld.github.io/nestjs/ch-11/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-11/<blockquote> <p><strong>예외 필터(Exception Filter)</strong> 는 처리되지 않은 예외를 가로채 일관된 에러 응답으로 변환한다.</p>https://lameld.github.io/nestjs/ch-12/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-12/<blockquote> <p><strong>인터셉터(Interceptor)</strong> 는 핸들러 실행 <strong>전후</strong>에 로직을 끼워 넣는다. 응답 변환·로깅·캐싱·타임아웃 등에 쓰며 RxJS 스트림을 다룬다.</p>https://lameld.github.io/nestjs/ch-13/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-13/<blockquote> <p><strong>태스크 스케줄링</strong>은 정해진 시각·주기로 작업을 실행한다. <code>@nestjs/schedule</code> 로 cron·인터벌·타임아웃을 선언적으로 등록한다.</p>https://lameld.github.io/nestjs/ch-14/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-14/<blockquote> <p><strong>헬스 체크</strong>는 앱과 의존 서비스(DB·외부 API·디스크)의 상태를 점검하는 엔드포인트를 제공한다. 로드밸런서·쿠버네티스 프로브에 쓰인다. <code>@nestjs/terminus</code> 를 사용한다.</p>https://lameld.github.io/nestjs/ch-15/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-15/<blockquote> <p><strong>CQRS (Command Query Responsibility Segregation)</strong> 는 상태를 바꾸는 <strong>명령(Command)</strong> 과 조회하는 <strong>쿼리(Query)</strong> 를 분리하는 패턴이다. 복잡한 도메인에서 읽기/쓰기 모델을 독립적으로 최적화한다.</p>https://lameld.github.io/nestjs/ch-16/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-16/<blockquote> <p><strong>클린 아키텍처</strong>는 비즈니스 규칙(도메인)을 프레임워크·DB·외부 세부사항으로부터 격리한다. 의존성은 항상 <strong>바깥에서 안쪽(도메인)으로</strong> 향한다.</p>https://lameld.github.io/nestjs/ch-17/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/ch-17/<blockquote> <p>NestJS는 <strong>Jest</strong> 기반 테스트를 기본 제공한다. 단위 테스트는 프로바이더 로직을, e2e 테스트는 요청→응답 전체 흐름을 검증한다.</p>https://lameld.github.io/nestjs/appendix/Thu, 17 Sep 2026 00:00:00 +0000https://lameld.github.io/nestjs/appendix/<blockquote> <p>부록 — 실무에서 자주 쓰는 설정 팁 모음.</p> </blockquote> <h2 id="1-ormconfigjson-동적-생성">1. ormconfig.json 동적 생성</h2> <p>과거 TypeORM은 <code>ormconfig.json</code> 정적 파일로 DB 설정을 읽었지만, 환경 변수 기반으로 동적 구성하는 것이 안전하다. NestJS 에서는 <code>TypeOrmModule.forRootAsync</code> + <code>ConfigService</code> 조합을 쓴다.</p>