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

Jin's Lab

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

Base64 Image

커스텀 도메인 전환 마무리할 때 놓치기 쉬운 파비콘 엑박 문제

J.Lab ·
목차

    최근 운영 중인 IT Story 블로그의 커스텀 도메인 이전 작업을 진행했다. 네이키드 도메인인 jinbytes.com은 아직 DNS 전파 과정에 있었지만, www가 붙은 www.jinbytes.com 주소는 정상적으로 도메인이 연결되기 시작했다.

    이제 사이트 간 이동 링크들을 정리할 시점이 되었다고 판단했다. 도메인을 바꾸는 과정에서 발생하는 작은 오차나 누락은 방문자 경험을 크게 해칠 수 있기 때문에 커스텀 도메인 전환 마무리 작업에 집중하기로 했다.

    링크 위젯 교체와 코드 블록 정리 작업

    내가 운영하는 다른 세 개의 블로그인 KidStory, IssueLog, Jin's Lab의 화면에는 '다른 블로그 바로가기' 링크 위젯이 각각 설치되어 있다. 이 위젯들의 목적지 주소를 기존 subdomain 형태에서 새로 적용된 www.jinbytes.com으로 일괄 변경하는 작업부터 시작했다.

    이전에 도메인 이전을 미리 대비하면서 HTML/CSS 코드 내에 주석으로 새로운 링크 블록을 만들어두었었다. 기존에 활성화되어 있던 it.jinbytes.com 관련 활성 코드 블록과, 미래를 위해 미리 작성해 두었던 주석 블록을 정리해서 하나로 통일하는 작업을 진행했다.

    노트북 화면에서 웹사이트 주소와 HTML 코드를 수정하는 개발자의 모습을 나타낸 일러스트

    주석 처리된 구역을 해제하고 기존 활성 블록을 깔끔하게 대체하면서 전체적인 태그 구조를 다듬었다. 코드가 깔끔하게 정리되는 모습을 보며 작업이 완벽하게 마무리되었다고 생각했다.

    배포 직후 발견한 아이콘 엑박 문제

    수정된 코드들을 적용하고 라이브 환경에 반영한 뒤, 실제로 세 개의 블로그에 접속해서 링크 위젯이 잘 동작하는지 확인해 보았다. 클릭 시 이동은 정상적으로 이루어졌지만, 의외의 곳에서 문제가 터졌다.

    각 블로그 바로가기 항목 옆에 표시되어야 할 작은 아이콘 이미지가 이른바 '엑박(이미지 깨짐 현상)'으로 노출되고 있었던 것이다. 주소 연결만 테스트하고 시각적인 요소는 완전히 놓칠 뻔한 순간이었다.

    웹 브라우저 화면에서 아이콘 이미지가 깨져 엑박으로 표시되는 모습을 표현한 일러스트

    원인을 찾기 위해 곧바로 브라우저 개발자 도구를 열어 HTML 구조를 뜯어보았다. 원인은 아주 명확하고 허탈한 곳에 있었다. 내가 미리 작성해서 주석으로 심어두었던 예비 코드의 <img> 태그 내부 src 속성이 완전히 비어있는 상태였던 것이다.

    base64 SVG 아이콘 복사로 즉시 해결

    과거에 주석 코드를 만들어 둘 때 '나중에 링크 바꿀 때 아이콘 src도 같이 집어넣어야지' 하고 비워둔 채 그대로 방치해 두었던 것이 화근이었다. 주석 속에 들어가 있다 보니 눈에 띄지 않았고, 막상 주석만 풀고 라이브에 올리니 비어있는 src 때문에 파비콘 엑박 현상이 그대로 드러난 것이다.

    해결 방법은 간단했다. 삭제하기 전 기존 it.jinbytes.com 코드 블록에 남아있던 원본 base64 SVG 아이콘 문자열 데이터를 찾았다.

    SVG 데이터 코드를 입력하여 엑박 문제를 깔끔하게 해결하는 과정을 나타낸 일러스트

    해당 base64 SVG 데이터를 그대로 복사해서, 주석을 풀어둔 새 블록의 <img src="..."> 자리에 빠짐없이 채워 넣었다. 저장 후 다시 배포를 진행하니 엑박이 사라지고 원래의 선명한 SVG 아이콘이 정상적으로 출력되는 것을 확인할 수 있었다.

    대비용 주석 코드를 작성할 때의 교훈

    이번 일은 단순한 오타나 경로 실수가 아니라, 나의 작업 습관에서 비롯된 시행착오였다. '나중에 도메인 바꿀 때 써야지' 하면서 주석으로 뼈대만 만들어 둘 때, 비어있는 속성을 대충 남겨둔 것이 원인이었다.

    미리 준비해 두는 대비용 코드라도 실제로 활성화할 때와 동일한 완벽한 상태로 작성해 두어야 한다는 아주 귀중한 교훈을 얻었다. 당장 화면에 보이지 않는 주석이라고 해서 방치하면, 실제 전환 당일에 허점이 그대로 노출된다.

    이번 커스텀 도메인 전환 마무리 과정을 통해 주석 코드의 완성도 체크에 대한 중요성을 다시 한번 깨닫게 되었다. 앞으로는 주석으로 작성하는 예비 코드 역시 작성 순간에 100% 동작 가능한 상태로 만들어 둘 생각이다.

    Base64 Image Custom Domain Debugging Log Domain Migration HTML Fix SVG Icon Web Development
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    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