Apps Script 프로젝트가 늘어나면 반드시 망가지는 것들
Apps Script 프로젝트가 늘어날수록 소유자, 트리거, 권한, 버전 관리가 흩어지는 문제를 정리합니다.
기술 노트
GAS로 직접 만드는 개발자를 위한 함정·코드·가이드라인. AXDX 구축의 밑바탕이 된 기록입니다.
매일 돌던 Apps Script 트리거가 갑자기 멈추는 이유
매일 돌던 Apps Script 트리거가 갑자기 멈추는 흔한 원인과 운영자가 먼저 확인해야 할 항목을 정리합니다.
브라우저 저장소에 고객정보 넣으면 생기는 문제
브라우저 저장소에 고객정보를 넣을 때 생기는 보안, 만료, 유출 위험을 비개발자도 이해할 수 있게 정리합니다.
브라우저가 내 데이터를 버릴 때: 초록 체크가 거짓말을 한다
모바일 localStorage는 용량이 차면 데이터를 조용히 버린다. 그런데 '저장됨' 플래그는 남아 완료 체크가 뜬다. 저장소 계층별 용도, 큰 본문을 IndexedDB에 두는 법, 열 때 정합성 검사, storage.persist()로 eviction 줄이기까지.
설치됨 ≠ 작동함: 백업 트리거가 한 번도 안 돌았다
GAS에서 스코프·트리거·권한은 에러 없이 조용히 실패한다. 매니페스트 스코프 하나가 빠지면 트리거가 한 번도 안 돈다. 왜 조용히 실패하는지, 멱등 설치로 20개 한도를 피하는 법, 하트비트와 '설치 직후 증명'까지.
GAS엔 점진 배포가 없다: '맞는' 검사 하나가 전 사용자를 잠근다
Apps Script는 promote 하는 순간 100% 사용자에게 나간다 — 카나리가 없다. push와 deploy의 차이, 새 검사를 compat → warn → enforce로 내보내는 법, 옛 클라이언트를 세는 텔레메트리, 그리고 사고 시 롤백 명령까지.
시트가 텍스트를 날짜로 바꾼다: '2026-06'이 완료를 영영 막을 때
구글 시트는 '2026-06' 같은 문자열을 조용히 Date로 강제 변환한다. 저장·읽기·비교가 각자 월을 다르게 계산하면 완료가 영원히 거부된다. 무엇이 강제 변환되는지, 셀을 텍스트로 고정하고 읽을 때 방어하는 법, 배치 쓰기와 수식 인젝션까지.
여러 사람이 한 시트에 쓰는 점검 앱: 동시성·중복·내보내기 설계
체크리포트 데모를 만들며 실제로 헤맨 지점과 코드. 공유 시트 동시 저장은 ScriptLock + 멱등 키로 막고, 셀에는 메타데이터만, 내보내기는 시간 예산으로 끊는다. 좋은 코드와 나쁜 코드를 함께 본다.
셀을 한 칸씩 읽지 마라: 서비스 호출이 진짜 비용이다
GAS에서 느린 건 자바스크립트가 아니라 Sheets·Drive 같은 서비스 호출이다. 루프 안 getValue/setValue를 일괄 getValues/setValues로 바꾸면 수십 배 빨라진다.
시트 셀에 JSON·이미지를 통째로 넣으면 터진다
구글 시트 셀은 5만 자에서 막힌다. 사진·서명을 data URL로 기록 행에 넣으면 저장이 깨진다. 셀에는 메타데이터만 남겨라.
웹앱 배포 설정 하나가 보안 모델을 정한다: Execute as / 접근 권한
‘누구로 실행’ × ‘누가 접근’ 조합이 데이터 권한과 코드 공개 여부를 결정한다. 공개 앱은 앱 레벨 인증을 따로 설계해야 한다.
GAS 6분 실행 한도: 멈추기 전에 끊어서 재개하라
Apps Script는 한 번 실행이 6분에서 강제 종료된다. 대량 작업은 청크 + 커서 + 시간 트리거 재개로 설계해야 절반만 처리되는 사고를 막는다.
PropertiesService는 데이터베이스가 아니다: 9KB의 벽
Properties 값은 한 개당 약 9KB가 한계다. 캐시는 유실돼도 되는 데이터에만. 큰 상태는 Sheet·Drive·외부 DB로. JSON 직렬화는 타입을 잃는다.
모바일에서 화면을 이미지로 저장할 때 멈추는 진짜 이유
SVG foreignObject로 DOM을 캡처하면 모바일 Safari·GAS iframe에서 멈추거나 빈 이미지가 나온다. 직접 캔버스에 그리고, 다운로드는 Web Share로 받아라.
동시에 같은 시트를 쓰면 깨진다: LockService와 30 동시 실행 천장
여러 사용자·트리거가 같은 자산을 쓰면 번호가 겹치고 행이 덮인다. tryLock + finally + flush로 막고, 동시 실행 30/user 천장을 설계에 넣어라.
재배포할 때마다 주소가 바뀌면 안 된다: /exec URL 고정
clasp으로 새 버전을 올릴 때 deployment ID를 재사용하면 /exec URL이 고정된다. 공유 시트 쓰기는 LockService로 막는다.
외부 호출은 가끔 실패한다: 지수 백오프와 재시도 예산
429·503·타임아웃 같은 일시적 실패는 재시도로 살릴 수 있다. 단 멱등성 없는 쓰기는 멱등키 없이 재시도하지 마라. 6분 안에서 멈춰라.
HtmlService 앱은 껍데기 먼저: 비동기 로드와 모바일 뒤로가기
템플릿에서 긴 데이터 로드를 하면 첫 화면이 늦는다. 껍데기를 먼저 그리고 google.script.run으로 비동기 로드하되, 모든 호출에 실패 핸들러를 붙여라.
GAS를 졸업해야 할 때: 한계 신호와 외부 DB 이전
GAS는 짧은 자동화에 강하고 장시간·대량·다수 동시에 약하다. 할당량은 계정 단위로 공유된다. 한계 신호를 미리 알고 이전 계획을 세워라.
GAS에 지능과 엔진룸을 더하기: Vertex AI와 Cloud Run
분류·요약·초안은 Vertex AI(Gemini)를 GAS에서 직접 호출해 더한다. 6분을 넘는 무거운 일은 Cloud Run으로 넘긴다. 단 사람 승인 게이트는 필수.