HTTP timeout, keep-alive, graceful shutdown

기본 패턴

server.requestTimeout = 30_000;
server.keepAliveTimeout = 5_000;

process.on("SIGTERM", () => {
  server.close(() => {
    process.exit(0);
  });
});

설명

• Node.js HTTP 서버는 단순히 listen()만 하면 끝나지 않습니다. 실제 운영에서는 느린 클라이언트, 반쯤 열린 연결, 종료 중인 서버가 남겨 둔 요청 같은 문제를 함께 다뤄야 합니다.
• requestTimeout, headersTimeout, keepAliveTimeout 같은 설정은 "얼마나 오래 기다릴 것인가"를 정합니다. 이 값들은 성능 옵션이라기보다 서버 보호 정책에 가깝습니다.
• keep-alive는 연결 재사용으로 성능을 높이지만, 종료 시점에는 기존 연결을 어떻게 정리할지도 함께 생각해야 합니다. 그렇지 않으면 배포 중 요청이 끊기거나 프로세스가 오래 남아 있을 수 있습니다.
• graceful shutdown은 보통 새 요청을 더 받지 않게 하고, 진행 중인 요청이 마무리될 시간을 준 뒤, 마지막에 자원을 정리하는 흐름입니다. SIGTERM 처리와 server.close()는 그 출발점입니다.
• 결국 HTTP 운영은 요청 처리 코드뿐 아니라 "서버가 언제까지 기다리고, 언제 어떻게 내려갈 것인가"를 계약처럼 정하는 작업입니다. 이 감각이 있어야 개발 서버와 운영 서버의 차이를 제대로 읽게 됩니다.

빠른 정리

주의할 점