개발
2026.09.16 · 2분
이 블로그를 만들면서 같은 함정에 세 번 빠졌다. 한 번은 "고친 코드가 반영되지 않았다" 는 잘못된 결론까지 냈다.
원인은 코드가 아니라 내가 잰 서버가 내가 띄운 서버가 아니었던 것이다.
프로덕션 모드로 띄울 때 이렇게 했다.
npm run start
이게 만드는 프로세스 사슬을 나중에 확인해 보니 세 단이었다.
npm run start
└─ sh -c next start
└─ next-server ← 포트 3000 을 쥔 것은 얘다
포트를 쥐는 것은 맨 끝의 프로세스다. 앞의 둘은 껍데기다.
그런데 나는 npm 프로세스 번호에 종료 신호를 보냈다. 앞의 둘만 사라지고 맨 끝은
부모가 바뀐 채 계속 살아 있었다. 종료 명령을 보낸 직후에도 요청을 받아 200 을
돌려줬다.
여기가 진짜 함정이다.
코드를 고치고 다시 빌드한 뒤 서버를 띄운다. 그리고 "떴나" 를 확인해야 한다. 나는 이렇게 했다.
curl -s -o /dev/null http://localhost:3000/ && echo 준비됨
새 서버는 포트를 못 잡고 죽는다. 이미 쥔 놈이 있으니까. 그런데 옛 서버가 200 을 돌려준다. 준비 확인이 통과한다.
그 상태로 측정하면 옛 빌드를 잰다. 고친 게 반영 안 된 것처럼 보인다.
세 번 당했고 그중 한 번은 그 결과를 근거로 "이 수정은 효과가 없다" 고 보고했다. 실제로는 효과가 있었다.
두 가지를 바꿨다.
포트를 누가 쥐고 있는지 직접 본다. 띄우기 전과 후에 본다.
ss -lptn | grep :3000
비어 있어야 띄우고, 띄운 뒤에는 내가 띄운 것이 잡고 있는지 본다. next-server 가
보이면 프로덕션 서버가 이미 떠 있다는 뜻이다.
사슬을 한 단으로 줄인다. npm run start 대신 직접 부른다.
npx next start -p 3000
이러면 종료할 때 헷갈릴 일이 없다.
여기서 한 번 더 사고가 났다. 다른 프로젝트에서 있었던 일인데, 안 죽는 서버가 답답해서 이런 걸 썼다.
pkill -f "next dev"
무관한 프로젝트의 개발 서버를 같이 죽였다. 같은 머신에서 Next 프로젝트 여러 개를 띄워 두고 있었기 때문이다.
지금은 포트나 프로세스 번호로 내가 띄운 것만 지정해서 종료한다.
이 프로젝트 저 프로젝트에서 같은 종류를 여러 번 만났다. 모아 보니 패턴이 보인다.
포트가 내 것인지 확인하지 않은 채 측정. 어떤 프로젝트에서는 3000 번이 다른 체크아웃이었다. 화면에 옛 데이터가 보이는데도 한참 코드를 뒤졌다.
개발 서버인지 프로덕션 서버인지 착각. 소스를 고치고 측정했는데 반영이 안 됐다. 그 포트는 예전에 띄워 둔 프로덕션 서버였다. 개발 서버라면 고치는 즉시 반영되지만 프로덕션 서버는 다시 빌드해야 한다. 이것도 두 번이나 "안 고쳐졌다" 고 잘못 판단하게 만들었다.
번들에서 문자열을 찾아 확인하려 한 것. 최소화가 변수 이름을 지워 버려서, 있는데도 없는 것처럼 나온다. 확인 방법으로 쓸 수 없다.
떠 있는 서버는 뜰 때 읽은 정보를 들고 있다. 서버를 켜 둔 채 빌드 산출물만 다시 만들면 옛 결과가 측정된다. 라우트 구성 같은 건 기동 시점에 읽고 안 다시 읽는다.
측정이 틀리면 틀린 코드보다 나쁘다. 틀린 코드는 고치면 되는데, 틀린 측정은 멀쩡한 코드를 고치게 만들고 진짜 원인에서 멀어지게 한다.
그래서 지금은 측정하기 전에 두 가지를 확인한다.
두 번째는 다른 프로젝트에서 배운 건데, 확대 막기를 검증하다가 "막혔다" 는 결과를 얻고 나서 알았다 — 그 검사는 막지 않아도 같은 결과가 나오는 것이었다.
세 번씩 당하고 나서야 저장소 문서에 적어 뒀다. 다음 사람이 — 아마 몇 달 뒤의 나겠지만 — 같은 결론을 다시 내지 않도록.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.