최근 발행했던 블로그 포스트의 대표이미지를 살펴보다가 무언가 크게 잘못되었다는 것을 발견했다. 포스트 상단에 위치해야 할 이미지가 온통 검은색 박스로 뒤덮인 채 렌더링되고 있었기 때문이다. 네트워크 응답 코드가 분명 200이었기 때문에 시스템상으로는 정상 처리된 것으로 판단했지만, 실제 결과물은 심각하게 훼손되어 있었다.
단순한 일시적 네트워크 오류라고 생각하기엔 깨진 양상이 낯익었다. 원인을 추적하고 해결하는 과정에서 API 통신의 허점을 다시금 파악하게 되었고, 이전에 작성해둔 정비 로직을 재활용하여 깔끔하게 복구할 수 있었다. 그 당시의 삽질과 해결 과정을 기록해 본다.
HTTP 200 응답 뒤에 숨은 바이너리 손상의 함정
이번에 대표이미지 깨짐 현상이 발생한 곳은 '손발 저림 원인과 대처법'이라는 글이었다. 개발자 도구를 열어 요소를 하나씩 뜯어보았을 때 상황은 자뭇 황당했다. 이미지의 naturalWidth와 naturalHeight 값은 정상적으로 잡혀 있었고, img.complete 속성 역시 true를 반환하고 있었지만, 눈에 보이는 화면은 완벽한 검은색이었다.
이것은 서버가 이미지를 다운로드받아 저장하는 스트리밍 과정에서 중간에 전송이 잘린 채 바이너리가 불완전하게 저장되었을 때 발생하는 전형적인 증상이다. 이전에 작업했던 학자금 상환 가이드 글에서도 똑같은 패턴의 사고를 겪은 적이 있었다. 그 당시에도 원인을 밝히느라 한참 동안 코드를 헤맸었다.
흔히 사용하는 상태코드 확인이나 Content-Type 헤더 검증만으로는 이러한 문제를 미리 잡을 수 없다. 통신 자체는 성공하여 HTTP 200을 반환했기 때문이다. 결국 API 상태코드 검증과 데이터의 실제 바이너리 손상 검증은 완전히 별개의 계층에서 이루어져야 한다는 사실을 깨달았다.
기존 복구 함수 재사용으로 과설계 피하기
다행히 파이프라인에는 이러한 재발을 방지하기 위한 안전장치가 마련되어 있었다. Apps Script 이미지 처리 파이프라인에 isCompleteImageBlob() 함수를 추가하여, 이미지 바이너리가 끝까지 제대로 수신되었는지를 판단하는 이미지 무결성 검증 방어 로직을 이미 배포해 둔 상태였다.
문제는 해당 방어 로직이 도입되기 전에 발행되었던 과거 포스트들에는 이 검증 스크립트가 소급 적용되지 않았다는 점이다. 즉, 시스템 업데이트 이전에 저장된 손상된 이미지 파일들이 시한폭탄처럼 여전히 서비스에 남아 있었던 셈이다.
새로운 복구 코드를 처음부터 다시 짜야 하나 잠시 고민했다. 하지만 똑같은 버그를 해결하기 위해 또 다른 코드를 덧붙이는 것은 불필요한 과설계라는 생각이 들었다. 나는 지난번 동일한 이슈가 발생했을 때 만들어 두었던 일회성 정비 함수인 fixBrokenHeroImage(blogName, postPath)를 그대로 재사용하기로 결정했다.
전용 실행 래퍼 작성과 Blogger 본문 패치
복구 작업은 빠르게 진행되었다. 프로젝트의 Code_이슈로그.gs 파일 내에 이번 손발 저림 글의 대표이미지를 전용으로 처리할 실행 래퍼 함수 runFixHandFootNumbnessImage()를 새로 추가해 주었다.
이 래퍼 함수 내부에서 기존의 fixBrokenHeroImage()를 호출하면, 새롭게 완전한 이미지를 생성하고 이를 검증한 뒤 Blogger API를 통해 포스트의 본문을 patch 방식으로 안전하게 교체하게 된다. 코드를 실행하자 손상되어 있던 바이너리가 정상적인 이미지 데이터로 깔끔하게 교체되었고, 블로그 상단의 검은 박스도 완전히 사라졌다.
이번 장애 복구 작업을 통해 HTTP 응답 상태만 믿고 넘어가는 방식이 얼마나 위험한지 다시 한번 체감했다. 서비스의 안정성을 고도화하기 위해서는 수신된 데이터의 내부 바이너리 무결성 검증이 반드시 수반되어야 한다. 또한 문제 발생 시 무작정 새 코드를 작성하기보다, 기존에 만들어 둔 검증된 재사용 루틴을 적절히 활용하는 것이 유지보수 측면에서 매우 현명한 선택이라는 점을 배웠다.