MV3 Service Worker 제약을 극복한 Stateless Google Drive Sync Engine 설계

Building a Google Drive Sync Engine that Survives MV3 Service Workers

Najmul Alam Miraj2026년 5월 12일4분intermediate

AI 요약

Context

Chrome Manifest V3(MV3) 도입으로 Background Script가 Service Worker로 대체되며 상태 유지 불가 및 임의 종료 제약 발생. 기존 MV2의 메모리 기반 Sync Queue 방식은 데이터 손실 위험이 커 기존 아키텍처의 전면 재설계가 필요했던 상황.

Technical Solution

모든 사용자 액션을 Local Storage에 즉시 저장하여 State-less한 Service Worker의 생명주기 제약을 극복한 설계
Local Storage를 Pending Sync의 단일 진실 공급원(Source of Truth)으로 활용하여 Worker 재시작 시 자동 복구 구조 구현
Timestamp 기반 Note ID와 Map 자료구조를 이용한 Local-Remote 데이터 Merge 로직으로 동기화 충돌 및 데이터 덮어쓰기 방지
Google API Client SDK를 제거하고 Google Drive v3 REST API를 직접 호출하여 Bundle Size 최적화 및 실행 속도 향상
Multipart HTTP Body를 Vanilla JavaScript로 직접 구성하여 의존성 없는 경량 네트워크 레이어 구축

실천 포인트

- Service Worker 기반 환경 설계 시 메모리 상태를 신뢰하지 말고 영속성 저장소를 우선 활용할 것 - SDK의 편의성보다 Bundle Size와 실행 속도가 중요한 제약 환경에서는 REST API 직접 호출을 검토할 것 - 분산 환경의 데이터 정합성을 위해 Timestamp 기반의 단순 Merge 전략과 Idempotency 확보 방안을 수립할 것

태그

#REST API #Stateless Architecture #Manifest V3 #Service Worker #Offline-First

원문 읽기