우문현답
愚 問 賢 答
회사별 면접직군별진행 방식
    홈›회사별›부동산플래닛›백엔드›질문 상세
    問
    부부동산플래닛백엔드직무 역량2026년 출제

    Spring REST Docs를 사용하여 문서화한 경험이 있다면 그 과정을 설명해 주세요.

    답변 미리보기

    팀 프로젝트에서 Spring REST Docs로 API 문서를 자동 생성한 경험이 있습니다. 처음엔 Swagger를 쓰다가 테스트 코드와 문서가 따로 관리되면서…

    예상 답변 시간
    60~90초
    예상 꼬리질문
    3회
    난이도
    난이도 중상
    출제 빈도
    높음
    INTERVIEWER'S INTENT · 면접관의 의도

    이 질문, 네 갈래로 뜯어봅니다.

    면접관이 이 한 문장으로 확인하려는 것들. 각 갈래를 알면 답의 뼈대가 잡혀요.

    問
    01
    어느 자리에서 어떤 결로 쓰는가?
    도구 자랑이 아니라 본인 작업 흐름에서 각 결이 어디에 들어가는지 답에 드러나는 결이 강합니다.
    骨
    02
    도구의 한계를 짚는가?
    좋아하는 도구의 약한 자리도 본인이 인정하는 결이 통합니다.
    語
    03
    본인 손에 닿은 자리가 있는가?
    이론 자랑이 아니라 본인이 어디서 그 결을 직접 짰는지 답에 드러나는 결이 강합니다.
    本
    04
    도구를 바꿔도 결이 살아나는가?
    한 도구에 묶이지 않고 결을 옮길 수 있는지 답에 흐르는 자리가 통합니다.
    말로 해봐야 는다
    읽는 것과 말하는 건 다릅니다.
    이 질문, 소리 내어 답해 볼까요?
    부동산플래닛 면접관 페르소나가 이 질문을 던지고, 당신의 답에 꼬리질문으로 되물어요.
    음성으로 답해보기
    Spring REST Docs로 테스트 기반 문서화 전환 경험약 60초REST Docs의 한계와 유지 비용 경험약 120초테스트 코드와 문서를 함께 짜면서 스펙을 명확히 한 경험약 120초
    A
    약 60초

    Spring REST Docs로 테스트 기반 문서화 전환 경험

    팀 프로젝트에서 Spring REST Docs로 API 문서를 자동 생성한 경험이 있습니다. 처음엔 Swagger를 쓰다가 테스트 코드와 문서가 따로 관리되면서 실제 동작과 문서가 달라지는 문제가 생겼습니다. REST Docs는 테스트가 통과해야 문서가 생성되는 구조라 테스트 기반 문서화 방식이 이 문제를 해결해줬습니다. 초기 설정이 Swagger보다 번거로웠지만, 문서가 항상 실제 동작과 동기화된다는 신뢰가 팀 협업 품질을 높여줬습니다. 프론트엔드 개발자가 문서만 보고 연동 작업을 진행할 수 있게 됐고, 인터페이스 불일치로 생기는 커뮤니케이션 비용이 크게 줄었습니다. 지금도 문서화 도구는 작성 비용보다 유지 동기화 비용을 먼저 고려해서 선택합니다.

    이 결의 특징
    Spring REST Docs 도입을 테스트와 문서가 따로 관리되던 문제라는 실제 계기로 풀어낸 흔적이 있습니다.
    이 결이 통하는 자리
    문서화 도구는 작성 비용보다 유지 동기화 비용을 먼저 고려해야 한다는 관점이 답에 담겨 있을 때 면접관의 신뢰가 쌓이는 자리를 자주 봅니다.
    예시 답변 2
    약 120초

    REST Docs의 한계와 유지 비용 경험

    Spring REST Docs를 팀 프로젝트에 도입하면서 좋은 점만큼이나 어려운 부분도 있었습니다. Swagger는 코드에 어노테이션을 추가하면 바로 UI가 생겼는데, REST Docs는 테스트 코드를 먼저 짜야 문서가 생성되는 구조라 초기 세팅 시간이 더 걸렸습니다. API가 많아지면서 모든 엔드포인트의 테스트를 유지하는 것도 부담이 됐는데, 테스트가 없으면 문서가 갱신되지 않아 미구현 엔드포인트는 문서에 빠져 있는 경우도 생겼습니다. 생성된 문서 형태가 AsciiDoc 기반이라 프론트엔드 개발자에게 익숙하지 않아 처음에 읽는 방법을 안내해야 했습니다. 이런 한계에도 문서와 실제 동작이 다를 때 생기는 혼란을 경험한 입장에서는, 초기 비용을 치르더라도 동기화가 보장되는 구조가 나중에 유리하다는 것을 배웠습니다. 문서화 도구를 고를 때는 작성 편의성보다 팀이 오래 유지할 수 있는 구조인지를 먼저 봐야 한다는 것을 이 경험에서 배웠습니다.

    이 결의 특징
    초기 세팅 시간과 테스트 유지 부담이라는 도구의 한계를 솔직하게 짚은 흔적이 있습니다.
    이 결이 통하는 자리
    작성 편의성보다 팀이 오래 유지할 수 있는 구조가 중요하다는 관점이 구체적으로 담긴 답에서 통합니다.
    예시 답변 3
    약 120초

    테스트 코드와 문서를 함께 짜면서 스펙을 명확히 한 경험

    Spring REST Docs를 처음 도입할 때 회원 가입 API의 테스트 코드를 먼저 작성했습니다. 요청 파라미터와 응답 필드를 문서로 남기려면 테스트 코드에서 각 필드를 명시적으로 기술해야 했는데, 이 과정에서 API 스펙을 다시 한 번 꼼꼼히 검토하게 됐습니다. 기존에 구현만 하고 넘어갔던 응답 필드 중 설명이 모호한 것들이 눈에 띄어, 문서화를 위해 스펙 자체를 명확히 하는 부수 효과가 있었습니다. 테스트가 통과하면 스니펫 파일이 생성되고, 이를 조합해 전체 API 문서로 만드는 흐름을 처음에는 번거롭게 느꼈는데 한 번 세팅하고 나니 반복 작업이 됐습니다. 새 API를 추가할 때마다 문서도 함께 생성되는 것이 자연스러운 습관이 됐고, 팀원이 문서를 보고 연동 작업을 진행하는 것을 보면서 문서화에 투자한 시간이 의미 있다는 것을 확인했습니다. 문서는 작성하는 사람이 아니라 읽는 사람을 위한 것이라는 것을 REST Docs를 직접 써보면서 실감했습니다.

    이 결의 특징
    문서화 과정에서 모호했던 응답 필드 스펙을 다시 검토하게 된 부수 효과를 짚은 흔적이 있습니다.
    이 결이 통하는 자리
    문서는 작성하는 사람이 아니라 읽는 사람을 위한 것이라는 관점이 답에 담겨 있을 때 면접관의 신뢰가 쌓이는 결이 보입니다.
    !
    위 답변은 여러 풀이 중 한 가지 예시입니다. 정답이 아니며, 외워서 그대로 말하면 면접관이 다음 질문을 그 자리에서 시작하는 경우가 많습니다. 본인의 프로젝트·기준·숫자로 다시 짜는 자리로만 쓰세요.
    ✕자주 빠지는 자리

    같은 실수가 반복돼요. 이것만 피해도 절반은 갑니다.

    • ✕떨어뜨린 옵션이 1개라도 있는가? "이게 답이었어요"만으로는 의사결정이 아니라 그냥 선택입니다.
    • ✕선택 기준이 그 프로젝트에 한정되는가? "성능이 좋아서"는 일반론, "우리 트래픽이 X 패턴이라서"가 본인의 답입니다.
    • ✕결과 숫자 1개를 정확히 말할 수 있는가? P95·QPS·적중률 — 무엇이든 1개. 숫자가 없으면 직감으로 한 일처럼 들리기 쉽습니다.
    • ✕지금 다시 한다면 어떻게 할지 답할 수 있는가? "잘했다"보다 "이건 다르게 했을 것 같다"가 더 깊은 인상을 남깁니다.
    ▶이어질 꼬리질문

    진짜 면접은 두 번째 질문부터예요. 이 답 뒤에 따라올 법한 것들.

    壹가장 자주 쓰는 기능 하나를 말씀해 주실 수 있나요?
    貳그 도구가 가장 답답했던 자리는 어디였나요?
    參새 도구로 옮긴다면 어디서 막힐 것 같으세요?
    이제, 직접 답해볼 차례예요.
    눈으로 읽은 답은 면접장에서 나오지 않아요. 부동산플래닛 면접관과 이 질문으로 한 번 대화해 보세요.
    이 질문으로 모의면접 해보기
    또는, 다음 질문으로

    같은 흐름에서 자주 이어지는 질문들이에요.

    이스트소프트 · 교사·강사
    Spring Framework와 REST API를 활용한 경험이 있다면 구체적인 사례를 말씀해 주세요.
    이 질문 보기
    이스트소프트 · AI 리서처
    Spring Framework와 REST API의 관계에 대해 간단히 설명해줄 수 있나요?
    이 질문 보기
    삼성전자 · 데이터 엔지니어
    RESTful API를 사용하여 데이터 시스템을 구축한 경험이 있다면 이야기해 주세요.
    이 질문 보기
    세나클소프트 · 백엔드
    RESTful API 개발 경험이 있다면, 어떤 방식으로 설계하고 구현했는지 설명해 주세요.
    이 질문 보기
    안내 · 이 페이지의 질문·답변·꼬리질문은 유사 직군 채용 시장의 공개된 면접 후기·커뮤니티 게시물을 분석해 구성한 학습 자료입니다. 실제 출제·회사 공식 입장과는 무관하며, 정정 요청 시 24시간 내 반영합니다. 자세히
    개인정보처리방침이용약관문의
    © 2026 우문현답. All rights reserved.
    이 페이지 목차
    01면접관의 의도02답변의 결03실수·꼬리질문04관련 질문
    말로 해봐야 는다
    이 질문, 부동산플래닛 면접관과
    음성으로 답해볼까요?
    모의면접 해보기
    첫 회 무료 · 종료 즉시 음성 폐기