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

Jin's Lab

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

BlogAutomation

블로그 자동화 제목 동기화 오류를 해결한 파이프라인 디버깅 기록

J.Lab ·
목차

    요즘 나는 글을 쓰고 배포하는 과정을 효율화하기 위해 다양한 자동화 도구를 적극적으로 활용하고 있다. 특히 Notion을 데이터베이스로 삼아 API를 연동하고, 콘텐츠 파이프라인 동기화를 구축해 글을 자동으로 발행하는 재미에 푹 빠져 있었다. 그런데 최근 잘 작동하던 Jin's Lab LinkedIn 재활용 발행 자동화 시스템에서 기이한 현상이 발생하기 시작했다.

    분명히 발행 대기 큐에 들어가 있어야 할 아이템들이 흔적도 없이 조용히 드롭되고 있었던 것이다. 에러 로그를 뜯어보니 URL 조회 실패가 원인이었는데, 처음에는 일시적인 네트워크 장애인 줄 알고 가볍게 넘겼다. 하지만 이 현상이 반복되면서 심각한 동기화 오류가 숨어 있음을 직감하고 본격적인 디버깅에 착수했다.

    데이터가 유기적으로 흐르는 클린한 아이소메트릭 스타일의 콘텐츠 파이프라인 일러스트

    조용히 사라진 발행 건, 원인은 Gemini의 제목 최적화

    원인을 분석해보니 범인은 엉뚱하게도 내 자동화 파이프라인의 핵심 비서인 Gemini였다. 내가 설계한 시스템은 발행 시점에 Gemini를 거쳐 제목을 더 매력적으로 최적화한 뒤 Blogger에 발행하도록 되어 있었다. 실제로 Blogger에는 멋지게 다듬어진 새로운 제목으로 글이 올라갔다.

    하지만 정작 기록 보관소 역할을 하는 Notion의 'SEO 제목' 필드는 갱신되지 않은 채 원래 키워드 DB 제목 그대로 남아 있었다. 결국 실제 발행된 글의 제목과 Notion에 기록된 제목이 일치하지 않아 시스템이 URL을 조회할 때 실패했고, 큐 아이템을 조용히 드롭하는 결과를 낳았다. Notion API 연동 과정에서 두 데이터의 불일치가 치명적인 에러로 이어진 것이다.

    재미있는 점은 내가 함께 운영하는 IssueLog나 KidStory 채널에서는 이런 GAS 자동화 버그가 전혀 발생하지 않았다는 사실이다. 그 이유를 찾아보니 아주 단순했다. IssueLog와 KidStory에는 애초에 Gemini를 통한 제목 최적화 기능 자체가 탑재되어 있지 않아, 원래 제목 그대로 일관되게 동기화되고 있었기 때문이다.

    데이터베이스 동기화 오류와 정합성 해결 과정을 시각화한 미니멀 일러스트

    동기화 로직 수정과 영문 슬러그 기반의 데이터 복구

    문제를 인지했으니 곧바로 코드 수정에 들어갔다. 가장 먼저 Notion의 상태를 업데이트하는 핵심 함수인 updateNotionStatus()의 구조를 변경했다. 발행 시점에 실제로 최적화되어 Blogger에 반영된 최종 제목을 파라미터로 추가하여 Notion의 'SEO 제목' 필드도 실제 발행값으로 동기화되도록 조치했다.

    이미 어긋나 버린 기존 데이터들을 맞춰주는 작업도 필요했다. 이를 위해 과거에 제목이 불일치하여 유실 위기에 처했던 22건의 데이터를 수동이 아닌 스크립트로 복구하기로 했다. 항상 일관되고 정확하게 유지되는 영문 슬러그 기준인 '추천퍼머링크' 값을 고유 키로 활용해 매칭하는 1회성 함수 repairJinsLabTitleMismatches()를 작성했다.

    이 복구 함수를 실행한 결과, 어긋나 있던 전체 22건의 데이터 중에서 유실될 뻔한 6건의 매칭 오류를 완벽하게 잡아내어 정상적으로 복구할 수 있었다. 영문 슬러그라는 확실한 기준점이 없었다면 일일이 수동으로 대조하며 삽질을 거듭했을 텐데, 구조화된 메타데이터 덕분에 수월하게 해결할 수 있었다.

    고유 키를 사용해 데이터 블록을 완벽하게 맞추는 정합성 복구 개념의 아이소메트릭 일러스트

    데이터 이중 관리의 함정에서 얻은 뼈아픈 교훈

    이번 블로그 자동화 제목 동기화 오류를 해결하면서 설계 관점에서 아주 큰 교훈을 얻었다. 동일한 성격의 데이터값을 실제 발행 서비스와 기록용 DB라는 두 군데의 저장소에 나누어 저장할 때 발생하는 전형적인 동기화 실패 사례였기 때문이다. 한쪽 저장소의 변경 사항이 다른 쪽에 실시간으로 전달되지 않는 구조는 언제든 시한폭탄이 될 수 있다.

    동기화가 어긋나는 순간, 시스템 내부에서는 이를 인지하지 못하고 조용히 데이터를 누락시키기 때문에 겉보기에는 원인을 알 수 없는 랜덤 버그처럼 느껴지기 마련이다. 콘텐츠 파이프라인 동기화를 설계할 때는 반드시 데이터의 단일 원천(Single Source of Truth)을 명확히 하거나, 상태 변화가 일어나는 즉시 양방향으로 동기화되도록 엄격한 예외 처리를 갖춰야 함을 뼈저리게 배웠다.

    수동으로 복구하느라 고생은 좀 했지만, 이번 디버깅을 거치며 나의 자동화 파이프라인은 한층 더 단단해졌다. 앞으로는 제목 최적화 같은 인공지능 개입 단계가 추가될 때, 데이터의 정합성을 최우선으로 고려하며 설계를 다듬어 나갈 생각이다.

    BlogAutomation Debugging GAS NotionAPI Synchronization
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    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