최근 운영 중인 IT Story 블로그의 커스텀 도메인 이전 작업을 진행했다. 네이키드 도메인인 jinbytes.com은 아직 DNS 전파 과정에 있었지만, www가 붙은 www.jinbytes.com 주소는 정상적으로 도메인이 연결되기 시작했다.
이제 사이트 간 이동 링크들을 정리할 시점이 되었다고 판단했다. 도메인을 바꾸는 과정에서 발생하는 작은 오차나 누락은 방문자 경험을 크게 해칠 수 있기 때문에 커스텀 도메인 전환 마무리 작업에 집중하기로 했다.
링크 위젯 교체와 코드 블록 정리 작업
내가 운영하는 다른 세 개의 블로그인 KidStory, IssueLog, Jin's Lab의 화면에는 '다른 블로그 바로가기' 링크 위젯이 각각 설치되어 있다. 이 위젯들의 목적지 주소를 기존 subdomain 형태에서 새로 적용된 www.jinbytes.com으로 일괄 변경하는 작업부터 시작했다.
이전에 도메인 이전을 미리 대비하면서 HTML/CSS 코드 내에 주석으로 새로운 링크 블록을 만들어두었었다. 기존에 활성화되어 있던 it.jinbytes.com 관련 활성 코드 블록과, 미래를 위해 미리 작성해 두었던 주석 블록을 정리해서 하나로 통일하는 작업을 진행했다.
주석 처리된 구역을 해제하고 기존 활성 블록을 깔끔하게 대체하면서 전체적인 태그 구조를 다듬었다. 코드가 깔끔하게 정리되는 모습을 보며 작업이 완벽하게 마무리되었다고 생각했다.
배포 직후 발견한 아이콘 엑박 문제
수정된 코드들을 적용하고 라이브 환경에 반영한 뒤, 실제로 세 개의 블로그에 접속해서 링크 위젯이 잘 동작하는지 확인해 보았다. 클릭 시 이동은 정상적으로 이루어졌지만, 의외의 곳에서 문제가 터졌다.
각 블로그 바로가기 항목 옆에 표시되어야 할 작은 아이콘 이미지가 이른바 '엑박(이미지 깨짐 현상)'으로 노출되고 있었던 것이다. 주소 연결만 테스트하고 시각적인 요소는 완전히 놓칠 뻔한 순간이었다.
원인을 찾기 위해 곧바로 브라우저 개발자 도구를 열어 HTML 구조를 뜯어보았다. 원인은 아주 명확하고 허탈한 곳에 있었다. 내가 미리 작성해서 주석으로 심어두었던 예비 코드의 <img> 태그 내부 src 속성이 완전히 비어있는 상태였던 것이다.
base64 SVG 아이콘 복사로 즉시 해결
과거에 주석 코드를 만들어 둘 때 '나중에 링크 바꿀 때 아이콘 src도 같이 집어넣어야지' 하고 비워둔 채 그대로 방치해 두었던 것이 화근이었다. 주석 속에 들어가 있다 보니 눈에 띄지 않았고, 막상 주석만 풀고 라이브에 올리니 비어있는 src 때문에 파비콘 엑박 현상이 그대로 드러난 것이다.
해결 방법은 간단했다. 삭제하기 전 기존 it.jinbytes.com 코드 블록에 남아있던 원본 base64 SVG 아이콘 문자열 데이터를 찾았다.
해당 base64 SVG 데이터를 그대로 복사해서, 주석을 풀어둔 새 블록의 <img src="..."> 자리에 빠짐없이 채워 넣었다. 저장 후 다시 배포를 진행하니 엑박이 사라지고 원래의 선명한 SVG 아이콘이 정상적으로 출력되는 것을 확인할 수 있었다.
대비용 주석 코드를 작성할 때의 교훈
이번 일은 단순한 오타나 경로 실수가 아니라, 나의 작업 습관에서 비롯된 시행착오였다. '나중에 도메인 바꿀 때 써야지' 하면서 주석으로 뼈대만 만들어 둘 때, 비어있는 속성을 대충 남겨둔 것이 원인이었다.
미리 준비해 두는 대비용 코드라도 실제로 활성화할 때와 동일한 완벽한 상태로 작성해 두어야 한다는 아주 귀중한 교훈을 얻었다. 당장 화면에 보이지 않는 주석이라고 해서 방치하면, 실제 전환 당일에 허점이 그대로 노출된다.
이번 커스텀 도메인 전환 마무리 과정을 통해 주석 코드의 완성도 체크에 대한 중요성을 다시 한번 깨닫게 되었다. 앞으로는 주석으로 작성하는 예비 코드 역시 작성 순간에 100% 동작 가능한 상태로 만들어 둘 생각이다.