최근 블로그의 반응형 레이아웃을 다듬던 중 기묘한 현상을 발견했다. 태블릿이나 모바일 환경을 모사한 768px 이하 화면에서 본문 콘텐츠 영역의 여백이 어딘가 어색해 보였다. 대충 눈으로 보기에는 좌우 대칭인 것 같았지만, 실제로 정밀하게 확인해 보니 좌우와 상하 여백이 제각각으로 놀고 있었다.
이 미세한 어긋남을 그냥 넘기기엔 내 성격상 허락하지 않았다. 결국 소매를 걷어붙이고 본격적인 Blogger 반응형 여백 디버깅 작업에 착수하게 되었다.
눈대중의 배신과 getBoundingClientRect 디버깅
처음에는 단순히 브라우저 개발자 도구의 모바일 프리뷰를 켜고 스크린샷을 찍어 확인했다. 스크린샷 상으로는 좌우 여백이 얼추 비슷해 보이는 착시가 발생해 정확한 원인을 찾기 어려웠다. 눈대중에 의존하는 디버깅은 시간만 낭비할 뿐이라는 생각이 들었다.
이를 확실하게 검증하기 위해 조금 정밀한 디버깅 방식을 적용하기로 했다. 우선 개발자 도구 콘솔에서 현재 페이지와 동일한 출처(same-origin)의 iframe을 768px 너비로 띄웠다. 그리고 자바스크립트의 getBoundingClientRect() 메서드를 활용해 각 레이어의 정확한 수치를 구했다.
정밀 측정 결과는 생각보다 충격적이었다. 콘텐츠 영역의 실제 여백이 좌 39px, 우 39px, 상 28px, 하 52px로 완전히 제각각 흩어져 있었기 때문이다. .jp-wrap부터 시작해 그 하위의 .jp-body, .jp-postlist로 이어지는 각 레이어의 인셋(Inset) 값을 숫자로 추적하고 나서야 문제의 실체가 보였다.
Blogger가 자동으로 주입한 15px의 비밀
왜 하필 좌우 여백이 39px라는 애매한 숫자가 나왔을까 고민에 빠졌다. 내가 코드에 지정한 .jp-wrap의 패딩은 분명히 24px였다. 그렇다면 남은 15px가 어디선가 굴러들어 왔다는 뜻인데, 과거 링크허브 페이지를 작업할 때 겪었던 동일한 패턴이 머리를 스쳤다.
원인은 Blogger 플랫폼 특유의 숨겨진 기본 스타일 때문이었다. Blogger는 템플릿 코드에서 showaddelement='yes' 속성이 들어간 섹션(나의 경우 #main.section)에 자동으로 15px의 마진(margin)을 주입한다. 이 문서화되지 않은 기본 마진 15px가 내가 직접 설정한 패딩 24px와 더해지면서 39px라는 해괴한 숫자를 만들어 낸 것이다.
이것이 반응형 레이아웃에서 여백이 들쭉날쭉해 보였던 근본적인 원인이었다. CSS margin 디버깅을 진행할 때는 내가 작성하지 않은 외부 플랫폼의 주입 스타일까지 꼼꼼히 살피는 시야가 필요하다는 사실을 다시금 절감했다.
삽질의 연속, 강제 제거와 패딩 조정이 남긴 버그
원인을 규명했으니 해결하는 일만 남았다고 생각하며 가볍게 첫 번째 시도를 해보았다. 문제의 주범인 Blogger의 자동 주입 마진을 없애기 위해 #main.section { margin: 0 !important; }를 스타일시트에 추가해 보았다. 하지만 화면을 새로고침하자마자 모바일을 포함한 모든 화면 크기에서 가로 스크롤바가 생기는 대참사가 발생하여 급히 코드를 롤백했다.
두 번째 시도로는 합산되는 수치를 맞추는 보정 방식을 택했다. 기존 패딩 24px를 5px로 줄이면, Blogger가 주입하는 15px 마진과 더해져 총 20px로 보기 좋은 여백이 될 것이라 생각했다. 하지만 이 역시 브라우저의 너비 계산식과 얽히면서 가로 스크롤 현상이 재현되었고, 결국 이 시도 역시 허사로 돌아갔다.
Blogger의 특정 영역 마진을 무리하게 강제 제거하거나 패딩으로 보정하려는 시도가 도리어 레이아웃의 가로폭 계산을 망가뜨리는 새로운 버그를 유발한 것이다. 단순한 수정이 되려 복잡한 문제를 키울 수 있음을 보여주는 삽질의 과정이었다.
결국 최고의 해결책은 원상복구였다
여러 번의 시행착오 끝에 나는 무리한 수정 대신 안전한 길을 택하기로 했다. 기존에 건드렸던 @media(max-width:960px) 제어 블록을 완전히 원상태로 되돌렸고, 오직 레이아웃 정렬을 위해 필요했던 align-items 수정 코드만 남겨두었다. 쓸데없는 마진 억제 코드를 모두 걷어낸 것이다.
이렇게 코드를 롤백한 뒤, 요청한 사용자가 화면을 새로고침하여 정상적으로 잘 출력되는 모습을 확인해 주었다. 우려했던 반응형 레이아웃 왜곡이나 스크롤 오류 없이 깔끔하게 렌더링되고 있었기에 추가 수정 없이 최종 완료 처리를 지었다.
이번 디버깅을 통해 모든 버그를 코드로 뜯어고쳐야 하는 것은 아니라는 귀중한 실전 교훈을 얻었다. 때로는 어떤 플랫폼의 기본 규칙을 억지로 깨뜨리며 수정하는 것보다, 부작용을 최소화하기 위해 그대로 유지하는 편이 훨씬 이롭다. 원인을 명확하게 찾아냈음에도 건드리지 않는 것이 최선의 해결책이 될 수 있다는 점을 항상 명심해야겠다.