path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

BloggerAPI

이미지 무결성 검증으로 HTTP 200 대표이미지 깨짐 해결한 기록

J.Lab ·
목차

    최근 발행했던 블로그 포스트의 대표이미지를 살펴보다가 무언가 크게 잘못되었다는 것을 발견했다. 포스트 상단에 위치해야 할 이미지가 온통 검은색 박스로 뒤덮인 채 렌더링되고 있었기 때문이다. 네트워크 응답 코드가 분명 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 응답 상태만 믿고 넘어가는 방식이 얼마나 위험한지 다시 한번 체감했다. 서비스의 안정성을 고도화하기 위해서는 수신된 데이터의 내부 바이너리 무결성 검증이 반드시 수반되어야 한다. 또한 문제 발생 시 무작정 새 코드를 작성하기보다, 기존에 만들어 둔 검증된 재사용 루틴을 적절히 활용하는 것이 유지보수 측면에서 매우 현명한 선택이라는 점을 배웠다.

    BloggerAPI DataValidation DebuggingLog GoogleAppsScript ImageIntegrity
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger