Express

Express는 Node.js에서 HTTP 요청을 받아 경로와 메서드에 맞는 처리를 연결하는 웹 애플리케이션 프레임워크입니다. 라우팅과 미들웨어를 조합해 웹 서버나 API를 구성합니다. 실행 환경은 Node.js가 제공하고 Express는 요청 처리의 구조를 맡으며, 데이터 저장과 인증 같은 기능은 애플리케이션이 필요한 구성 요소를 연결해 구현합니다.

요청을 처리 함수에 연결하는 라우팅

Express 공식 소개는 Express를 Node.js용의 작고 유연한 웹 애플리케이션 프레임워크로 설명합니다. 웹 요청을 받았을 때 실행할 함수를 정하고 응답을 만드는 데 필요한 기능을 제공합니다. 브라우저 화면을 그리는 UI 라이브러리와는 역할이 달라, 화면에서 보낸 요청을 서버에서 받아 처리하는 구성을 만드는 데 쓰입니다. 서버가 어떤 주소를 제공하고 어떤 데이터를 반환할지는 작성한 애플리케이션이 결정합니다.

Express 라우팅 문서는 요청 메서드와 경로의 조합으로 라우트를 정의한다고 설명합니다. 같은 경로라도 GET과 POST에 다른 함수를 연결할 수 있습니다. 문서의 app.get()과 app.post()는 이런 HTTP 메서드별 연결을 나타냅니다. 요청이 등록한 조건과 일치하면 연결된 처리 함수가 실행됩니다. 주소에 포함된 쿼리 문자열은 라우트 경로 자체의 일부로 취급하지 않는다는 조건도 함께 명시됩니다.

처리 함수는 요청 정보와 응답을 다루는 객체를 받습니다. 요청 본문이나 경로 매개변수에서 값을 읽고, 필요한 동작을 수행한 뒤 응답합니다. 주문 번호가 담긴 경로에서 번호를 읽을 수 있다는 사실과 그 번호가 실제 주문을 가리키는지는 별개입니다. 값의 형식과 접근 권한, 존재 여부는 애플리케이션이 확인할 조건입니다.

미들웨어를 이어 붙이는 처리 흐름

Express 공식 소개는 작은 핵심 기능에 미들웨어 모듈을 추가하는 구성을 설명합니다. 미들웨어는 요청 처리 과정에 들어가는 함수로, 다음 단계에 값을 넘기거나 응답을 끝내는 일을 할 수 있습니다. 요청을 기록하는 함수, 입력을 읽는 함수, 인증 상태를 확인하는 함수처럼 처리 단계를 나누어 연결하면 어느 단계가 어떤 책임을 맡는지 코드에 드러납니다.

라우팅 문서는 한 경로에 처리 함수를 여러 개 연결하고 next()로 다음 함수에 제어를 넘기는 방법을 안내합니다. 함수의 등록 순서와 다음 단계 호출 여부가 실행 흐름에 영향을 줍니다. 응답을 이미 보낸 뒤 또 다른 함수가 응답하려 하거나, 다음으로 넘겨야 할 곳에서 처리가 멈추면 기대한 결과가 나오지 않을 수 있습니다. 함수가 호출됐는지와 응답이 끝났는지를 함께 보면 요청이 멈춘 위치를 좁힐 수 있습니다.

여러 경로를 기능별로 묶는 데는 express.Router()를 사용할 수 있습니다. 공식 문서는 Router를 모듈화된 라우트 처리 객체로 설명합니다. 회원 기능과 게시물 기능을 서로 다른 파일에 나누더라도 최종 앱에서 어느 경로에 연결했는지가 실제 주소를 결정합니다. 파일을 만들었다는 사실만으로 그 라우터가 서버의 요청 처리에 참여하는 것은 아닙니다.

서버 실행과 애플리케이션 검증

Express는 요청 처리 틀을 제공하며 데이터를 저장할 데이터베이스나 완성된 사용자 권한 정책까지 하나로 정하지는 않습니다. SDK나 데이터베이스 클라이언트를 호출하는 코드를 라우트 안에 넣었다면 연결 실패와 입력 오류를 어떤 응답으로 돌려줄지도 설계 대상입니다. 서버가 실행 중이라는 상태, 경로가 일치했다는 상태, 외부 작업까지 성공했다는 상태는 구분됩니다.

2026년 10월 11일 확인한 라우팅 문서는 Express 4와 5에서 일부 경로 패턴의 처리 방식이 다르다고 경고합니다. 기존 예제를 옮길 때는 설치된 주 버전과 문서의 대상을 맞춥니다. 경로가 열리지 않는 문제를 조사할 때도 메서드, 실제 주소, 라우터 연결 위치, 사용한 버전을 함께 확인합니다. 생성형 AI가 만든 코드라면 함수 이름이 문서에 존재하는지와 정상 요청·잘못된 요청에 대한 응답을 실제 환경에서 대조할 수 있습니다.