로컬에서만 잘 된다고 말하는 개발자에게

by 그릿 | GROWTH_ESSAY | 2026-08-02

"제 노트북에서는 잘 되는데 왜 서버에서는 에러가 나는지 모르겠습니다."

200명 넘는 백엔드 주니어 개발자들을 멘토링하며 거의 매주 듣는 문장입니다. 로컬 터미널에서 API 응답이 제대로 나오는 것을 확인했으니, 자신의 코드는 아무런 문제가 없다고 확신합니다. 하지만 스테이징 환경이나 프로덕션 서버에 배포하는 순간 예외가 터지고 서버가 먹통이 됩니다.

왜 이런 일이 반복해서 벌어질까요?

로컬 환경과 운영 환경은 완전히 다른 세상입니다

주니어 개발자가 자주 놓치는 사실이 있습니다. 작성한 코드가 실행되는 '실제 환경'을 전혀 고려하지 않는다는 점입니다.

로컬 DB에 들어있는 테스트 데이터는 고작 10건에 불과합니다. 반면 운영 DB에는 50만 건이 넘는 레코드가 쌓여 있습니다. 로컬에서는 데이터 10개를 한 번에 메모리에 올리고 처리해도 5밀리초 만에 끝나지만, 운영 환경에서는 메모리가 부족해 서버가 바로 멈춥니다. 환경 변수 차이 하나, DB 커넥션 풀 개수 설정 하나만 달라져도 완전히 다른 동작이 일어납니다. 그런데도 많은 주니어 개발자들은 오직 자신의 맥북 화면만 바라보며 코드가 완벽하다고 믿습니다.

단 하나의 해피 패스만 확인하고 개발을 끝냅니다

지난달 멘토링을 진행했던 2년 차 개발자 A씨의 사례입니다. API 배포 직후 500 에러가 발생하자 A씨는 "제 로컬 톰캣에서는 정상 동작했습니다"라는 말만 반복했습니다.

어떤 조건에서 요청이 실패하는지, 엣지 케이스 테스트는 해보았는지 물었지만 아무런 대답을 하지 못했습니다. 에러가 나지 않는 정상적인 입력값 하나만 로컬에서 직접 쳐보고 '개발 완료'라고 단정 지었던 것입니다. 경력 개발자가 말하는 검증과 주니어 개발자가 말하는 '제 컴퓨터에서는 되는데요' 사이에는 이만큼 큰 간극이 존재합니다.

실행 환경까지 제어하는 것이 진짜 개발자의 역량입니다

실력 있는 개발자는 코드 몇 줄을 더 적는 것보다 로컬과 운영 환경의 격차를 줄이는 일에 훨씬 많은 공을 들입니다.

도커를 활용해 로컬과 서버의 실행 환경을 동일하게 맞추고, 모의 데이터를 충분히 쌓아 극단적인 엣지 케이스까지 직접 테스트합니다. 로컬에서 실행이 성공했다는 건 단지 문법 오류가 없음을 확인한 것에 불과합니다. 진짜 검증은 서버의 제한된 리소스, 네트워크 지연, 동시 요청이 쏟아지는 상황 속에서 내 코드가 견디는지를 확인하는 과정입니다.

"내 컴퓨터에서 된다"는 한마디로 책임을 마무리짓지 마십시오. 개발자의 작업은 로컬 환경에서 켜보는 것으로 끝나지 않습니다. 운영 환경에서 안전하게 숨 쉬고 동작할 때 비로소 코드는 완성됩니다.