최근 블로그를 운영하면서 참 당혹스러운 일을 겪었습니다. 글을 작성할 때 사용 중인 텍스트 정제 함수인 sanitizeGeminiHtml을 적용하기 이전의 과거 글들에서, 본문에 의문의 리터럴 'n' 문자가 그대로 노출되고 있는 것을 발견했기 때문입니다. 자동화 로직을 도입하면 모든 것이 해결될 줄 알았는데, 과거의 데이터들이 발목을 잡고 있었습니다.
새로 발행하는 글들은 문제없지만, 이미 쌓여있는 방대한 양의 글들을 일일이 수동으로 수정하는 것은 사실상 불가능했습니다. 그래서 아예 마음을 먹고 이를 해결하기 위한 일회성 마이그레이션 함수를 만들기로 했습니다. 소 잃고 외양간 고치는 격이라도, 늦었을 때가 가장 빠른 법이니까요.
repairLiteralNewlines 함수로 자동 정제하기
본격적으로 Blogger API를 활용해 대대적인 정비에 나섰습니다. 저는 코드 관리와 블로그 이슈 로그, 그리고 운영 중인 기술 블로그까지 총 3개의 스크립트 파일에 repairLiteralNewlines 함수를 이식했습니다. 이 함수는 API를 통해 블로그 내 전체 글을 순회하며 리터럴 'n'이 포함된 글만 골라냅니다.
골라낸 글들은 기존의 sanitizeGeminiHtml 함수를 거쳐 깔끔하게 다듬은 뒤, Blogger API PATCH 메서드를 사용해 재발행하는 방식을 택했습니다. 여기서 핵심은 원문 URL이나 발행일 같은 메타데이터는 그대로 유지하면서 오직 본문 내용만 교체하는 것이었습니다. 혹시라도 데이터가 유실될까 봐 테스트 단계에서 꽤나 조마조마했습니다.
실제 마이그레이션 실행 및 결과 분석
스크립트 작성을 마치고 Apps Script 편집기에서 수동 실행을 시작했습니다. 우선 가장 긴장했던 KidStory부터 확인했는데, 62건 중 0건의 오류가 발견되었습니다. 다행히 이미 정제된 상태였던 모양입니다.
다음으로 Jin's Lab은 다수의 글에서 리터럴 'n'이 발견되어 즉시 수정 작업이 진행되었습니다. 마지막으로 IssueLog는 119건 중 3건이 포착되어 정상적으로 처리되었습니다. 모든 수정 과정은 무사히 마무리되었고, 이제 과거의 찌꺼기들이 말끔히 정리되었습니다.
텍스트 가독성 개선 및 운영 교훈
이번 기회에 텍스트 정제 외에 한 가지 소소한 개선을 더 진행했습니다. 각 테마에서 IT Story로 연결되는 링크 텍스트의 가독성을 높이기 위해, href 주소는 기존의 www.jinbytes.com을 유지하되 화면에 표시되는 텍스트만 'jinbytes.com'으로 변경했습니다.
이번 작업을 통해 데이터 정제 로직을 파이프라인에 추가했다고 해서 모든 작업이 끝나는 게 아니라는 점을 뼈저리게 느꼈습니다. 로직이 적용되기 전의 과거 데이터를 훑어서 고쳐주는 일회성 마이그레이션 함수야말로 진정한 문제 해결의 마침표라는 사실을 알게 된 값진 경험이었습니다.