2 min read · 491 words
이 글은 Blogger 테마를 수정하고 저장했으나 라이브 페이지에 변경 사항이 반영되지 않아 고통받는 개발자를 위한 글이다. 내가 직접 겪은 Blogger 테마 저장 오류 현상과, UI 성공 메시지에 속지 않고 문제를 즉시 해결한 과정을 공유한다.
운영 기록 기준, 나는 Blogger의 theme.xml 파일 내 <b:skin> CDATA 블록 내부의 CSS 주석을 정리하고 있었다. 주석 안에 pre / code / div 같은 단어 설명을 추가하기 위해 /* pre / code 블록은 <pre>, <code> tag로 처리 */와 같이 작성했다. 그런데 이 수정을 마치고 테마를 저장했으나, 실제 블로그에는 변경 사항이 전혀 반영되지 않는 문제가 발생했다.
에러 증상
Blogger UI 상에서는 "저장 완료" 메시지가 정상적으로 표시되었다. 그러나 라이브 페이지를 fetch하여 소스를 확인했을 때, 수정하기 전의 옛 테마 코드가 그대로 노출되었다. 5분이 지나도, 다른 컴퓨터의 시크릿 모드로 접속해도 여전히 옛 테마가 캐싱된 것처럼 보였다. 구글의 '저장 완료' 팝업은 가끔 영혼 없는 영창과 같다. 믿지 말고 라이브 소스 크기를 직접 확인하자. UI는 성공을 외치지만 실제로는 백엔드에서 silent reject(조용한 거부)가 발생한 상태였다.
환경
내부 테스트 기준 환경은 다음과 같다.
- 플랫폼: Blogger (Google Blogspot)
- 대상 파일: theme.xml
- 수정 위치: <b:skin><![CDATA[...]]> 블록 내부의 CSS 주석 (
/* ... */)
시도했지만 실패한 방법
내가 문제를 해결하기 위해 시도했으나 실패한 방법들은 다음과 같다.
- 수동 업로드 재시도: XML 파일을 통째로 다시 업로드했으나 동일하게 무시되었다.
- 5분 캐시 대기: CDN 캐시 지연인가 싶어 대기했으나 라이브 소스는 변하지 않았다.
- 다른 컴퓨터 시크릿 모드 fetch: 브라우저 캐시 문제인지 의심하여 완전히 다른 환경에서 접속했으나 모두 옛 테마만 노출되었다.
최종 해결
정확한 원인은 추가 확인이 필요하지만, 현재 확인된 원인은 다음과 같습니다. Blogger의 SkinVariables 파서가 CDATA 내부의 CSS 주석 안에 포함된 <pre>와 <code> 텍스트를 실제 HTML 엘리먼트로 오인하여 파싱을 시도하다가 InvalidVariableException을 발생시킨 것으로 보입니다. 내가 적용한 최종 해결책은 CSS 주석 내의 raw HTML 토큰을 완전히 제거하는 것이었다. 꺾쇠괄호(< >)를 없애고 단순 텍스트인 pre, code로 변경하자마자 정상적으로 저장이 반영되었다.
사용한 코드
내부 테스트 기준, 문제가 되었던 코드와 수정한 코드는 다음과 같다.
<!-- Before (silent reject 발생) -->
/* pre / code 블록은 <pre>, <code> tag로 처리 */
<!-- After (정상 반영 성공) -->
/* pre / code 블록 처리 */검증 결과 및 현재 상태
수정 후 테마를 재업로드하자 라이브 페이지의 소스 크기가 286,391 bytes에서 294,194 bytes로 정상 변경되었다. 또한 SESS140 5 sentinel이 라이브에 도달한 것을 직접 검증했다. 현재 상태는 fixed이다.
같은 문제 겪는 분들에게
Blogger 테마 저장 오류 현상을 겪고 있다면, 가장 먼저 <b:skin> CDATA 내부의 CSS 주석을 확인하라. 주석 안에 무심코 작성한 <pre>, <code>, <div> 같은 HTML 태그 형태의 문자열이 파서를 망가뜨리고 있을 확률이 매우 높다. 주석 내 꺾쇠괄호부터 지우고 다시 업로드해 보라.
Category Coverage Notice
This article follows our label-specific editorial criteria. Details: