API 응답에 엔티티를 그대로 노출하는 개발자에게
by 그릿 | GROWTH_ESSAY | 2026-11-17
#백엔드 #JPA #커리어"어차피 필드 구성이 똑같은데 굳이 DTO 클래스를 또 만들어야 하나요?"
멘토링에서 주니어 백엔드 개발자들의 코드를 볼 때 자주 마주치는 장면입니다. 컨트롤러의 반환 타입에 JPA 엔티티가 그대로 적혀 있습니다. 객체를 하나 더 정의하고 매핑하는 작업이 번거로운 중복 노동처럼 느껴졌을 겁니다.
로컬에서 테스트하면 원하는 JSON 결과가 잘 내려옵니다. 기능도 잘 돌아갑니다. 하지만 저는 그 자리에서 단호하게 말씀드립니다. 그 코드는 운영 서버에 언제 터질지 모르는 시한폭탄을 심어둔 것과 같습니다.
화면 하나 때문에 테이블 구조가 바뀌는 비극
엔티티를 응답으로 내보내는 순간 데이터베이스 스키마와 외부 인터페이스가 한 몸으로 묶여버립니다. 테이블 컬럼 이름을 하나 수정했을 뿐인데, 그 엔티티를 소비하던 프론트엔드와 모바일 앱에서 즉각 에러가 터집니다.
반대로 화면 요구사항에 맞춰 응답 포맷을 바꾸려고 엔티티에 비즈니스와 무관한 계산 로직이나 가공 필드를 덕지덕지 붙이기 시작합니다. 저희가 200명 넘는 멘티의 프로젝트를 지켜보면서, 엔티티가 화면의 노예로 전락해 데이터 모델의 순수성을 잃어버리는 경우를 수없이 목격했습니다.
데이터베이스의 영속성을 책임지는 객체와 외부와 소통하는 통신 규약은 태생부터 목적과 생명주기가 완전히 다릅니다. 이 둘을 하나로 묶는 순간 시스템의 유연성은 사라집니다.
순환 참조와 의도치 않은 개인정보 유출
더 무서운 것은 보안과 장애입니다. 엔티티 안에는 대외적으로 공개되어서는 안 되는 정보들이 함께 담겨 있습니다. 회원의 비밀번호 해시값, 내부 계좌번호, 관리자 전용 플래그가 직렬화 라이브러리를 거치며 사용자 브라우저의 개발자 도구에 고스란히 찍힙니다. 실서비스 배포 첫 주차에 이런 실수를 뒤늦게 발견하고 식은땀을 흘리는 주니어를 정말 많이 만났습니다.
양방향 연관 관계가 걸리는 순간 문제는 더 심각해집니다. 엔티티를 그대로 반환하면 직렬화 과정에서 서로를 끝없이 참조하다가 스택오버플로우 에러를 내며 서버를 다운시킵니다.
지연 로딩으로 설정해둔 필드를 읽어오는 과정에서도 뷰 렌더링 시점에 수십 번의 추가 쿼리가 쏟아집니다. 로컬에서는 보이지 않던 병목이 실서버에서 대량 조회가 발생하는 순간 커넥션 풀을 모조리 말려버립니다.
경계를 지키는 귀찮음이 엔지니어의 품격입니다
DTO를 만드는 일은 불필요한 중복 코드가 아닙니다. 시스템의 내부 데이터와 외부 세상 사이에 안전한 방화벽을 세우는 일입니다.
어떤 데이터를 내보낼지 통제권을 온전히 개발자가 쥐어야 합니다. 화면 스펙이 아무리 자주 흔들려도 도메인 핵심 규칙을 품은 엔티티는 단단하게 보호받아야 합니다.
복사 작업 몇 줄이 귀찮다고 경계를 허무는 순간, 그 대가는 운영 서버의 장애와 보안 사고라는 가혹한 청구서로 돌아옵니다. 지금 작성 중인 컨트롤러의 반환형을 확인해 보십시오. 엔티티 이름이 적혀 있다면 망설이지 말고 DTO를 만드십시오.