레거시 코드 3개월 리팩토링하면서 배운 것
입사하고 처음 맡은 게 8년 된 모놀리식 서비스였습니다. 테스트도 없고, 주석은 죄다 옛날 담당자 이름만 남아 있고, 빌드하는 데만 20분 걸리는 상태였어요. 팀장님은 "일단 돌아가니까 건드리지 마"라고 했지만 그 상태로 기능 추가를 계속하다간 진짜 큰일 나겠더군요.
첫 달은 아무것도 안 하고 코드만 읽었습니다. 어디서부터 흐름이 시작되는지, 이 함수가 왜 이렇게 생겼는지, 왜 이 모듈이 다른 모듈을 다섯 번 거쳐 호출되는지. 시간 아깝다고 느낄 수 있는데, 이 과정을 건너뛰고 바로 손대면 반드시 갚아야 할 빚이 생깁니다.
두 번째 달부터는 테스트를 먼저 붙였습니다. 기능을 고치기 전에 현재 동작을 고정하는 테스트를 쓰는 방식으로요. 여기서 핵심은 '이상한 동작도 그대로 테스트로 박제한다'였습니다. 원래 그렇게 동작하던 걸 무심코 고쳐버리면 다른 데서 터지니까요.
세 번째 달에 리팩토링을 시작했는데, 원칙은 두 개만 지켰습니다.
- 한 번에 하나만 바꾼다: 구조를 바꾸면 로직은 안 건드리고, 로직을 바꾸면 구조는 그대로 둔다.
- 커밋은 작게, 배포는 자주: 거대한 PR 하나보다 작은 PR 열 개가 리뷰도 쉽고 롤백도 쉽습니다.
결과적으로 빌드 시간은 20분에서 4분으로 줄었고, 무엇보다 기능 추가할 때 겁이 안 나게 됐습니다. 성능이 극적으로 좋아진 건 아니지만 그게 목적도 아니었고요.
돌아보면 가장 도움이 된 건 "리팩토링은 코드를 예쁘게 만드는 게 아니라 변경을 안전하게 만드는 일"이라는 관점이었습니다. 같은 상황에 계신 분들 있으면, 일단 테스트부터 붙이시는 걸 추천합니다.
10 개의 답변
이거 맞음ㅋㅋ 특히 첫 달 코드만 읽기 진짜 중요한데 다들 시간 아깝다고 스킵함
글쎄 그건 좀. 빌드 20분이면 리팩토링보다 빌드 파이프라인부터 손대는 게 순서 아닌가 싶은데
출처 있음? 마틴 파울러 책인가
테스트로 이상한 동작 박제하는 거 진짜 공감. 근데 그거 하다 보면 '이거 원래 버그 아님?' 싶은 거 엄청 많이 나오죠 ㅋㅋ
한 번에 하나만 바꾼다 진짜 명심해야 하는데 하다 보면 욕심나서 두세 개씩 건드리다가 롤백하는 나...
오 이건 몰랐네. 테스트를 먼저 붙인다는 발상은 알겠는데 '현재 동작을 고정한다'는 표현이 확실히 와닿네요
동의 안 됨. 첫 달을 온전히 코드 읽는 데 쓴다는 게 사수 있는 팀에서나 가능한 얘기지, 기능 개발 일정 밀린 상태에서는 현실적으로 어렵습니다. 그 시간에 로그라도 찍어보면서 파악하는 게 낫지 않나요?
3개월 만에 8년 된 모놀리스를 손댈 수 있는 상태로 만든 것 자체가 대단한데요. 저희 팀은 비슷한 상황에서 '일단 돌아가니까' 하다가 2년 뒤에 결국 다 갈아엎었습니다. 그때 테스트라도 있었으면 최소 반년은 아꼈을 거예요.
공감합니다. 저도 비슷한 상황에서 리팩토링 진행했는데, 결국 가장 큰 적은 코드가 아니라 '건드리지 마'라고 하는 사람이었어요. 설득 자료로 장애 이력이랑 신규 기능 개발 소요시간 비교표를 만들어서 보여드리니 그제야 이해하시더라고요.
저도 그 모놀리식 8년차 서비스에 테스트 없이 주석만 옛날 담당자 이름 있는 거... 너무 익숙한 풍경이라 웃프네요. 근데 진짜 무서운 건 그 옛날 담당자들이 다 퇴사했다는 거죠. 물어볼 사람도 없이 git blame만 붙잡고 몇 주를 보냈습니다 ㅠㅠ