카테고리

배포와 인프라

작은 제품들을 계속 살리며 겪은 배포, 캐시, 색인, 로컬 자동화 기록.

전체 글

개념 도식: 왼쪽에는 이름이 지워진 본문 문단, 오른쪽에는 같은 이름이 그대로 박혀 있는 URL 경로와 OG 이미지 파일명.

배포와 인프라2026-09-276 분 읽기

본문에서 지운 이름이 URL에 그대로 남아 있었다

블로그와 내부 문서에서 식별자 두 개를 가리는 작업을 했습니다. 문장 속 이름만 고치면 되는 일인 줄 알았는데, 하나는 글 파일명, 곧 URL 슬러그 안에 들어 있었습니다. 이름을 바꾸면 URL과 OG 이미지, 문서 속 목록까지 같이 바뀌어야 했습니다.

#privacy#slug#build-output#grep

개념 도식: 용도를 지정하지 않은 진동이 터치 피드백으로 자동 분류돼 기기 설정에 의해 꺼지는 흐름

배포와 인프라2026-09-168 분 읽기

제 진동은 제가 건드린 적 없는 설정에 꺼져 있었습니다

진동은 화면에 안 보이고 에뮬레이터에서는 느낄 수도 없습니다. 시스템 로그로 판정하는 방법을 세우다, 우리 호출이 기기 설정 하나에 통째로 꺼질 수 있다는 걸 알았습니다.

#android#verification#gotchas#debugging

개념 도식: 같은 '취소' 사유가 한쪽 플랫폼에서는 0.2초, 다른 쪽에서는 6.5초로 서로 다른 현상을 가리키는 대조도

배포와 인프라2026-09-167 분 읽기

'사용자가 취소함'이 0.2초 만에 돌아왔습니다

로그인 실패 수백 건의 사유가 '취소'였습니다. 라벨을 믿지 않고 경과 시간을 같이 재보니, 같은 이름 뒤에 완전히 다른 두 현실이 있었습니다.

#ios#retention#debugging#verification

개념 도식: 폰이 보낸 메시지를 받을 델리게이트가 워치 쪽에 없어 전송만 성공으로 기록되는 구조

배포와 인프라2026-09-167 분 읽기

회복 점수는 언제나 72였습니다

워치 앱이 있는 앱 8개의 폰↔워치 연동을 대조했습니다. 7개는 실배선이었고, 1개는 화면만 있고 받는 쪽이 없는 껍데기였습니다.

#ios#app-store#gotchas#reality-check

왼쪽: 새로 늘린 앱이 대조군에 섞여 예측치를 부풀리고 개입군 합격선이 저절로 세진다. 오른쪽: 대조군에서 빼면 오염은 사라지지만 그 증설이 어느 판정에도 안 들어가 감시 구멍이 된다

배포와 인프라2026-09-1510 분 읽기

대조군을 지키려고 제 증설을 뺐더니, 그걸 판정하는 곳이 한 군데도 없어졌습니다

판정 하나가 오염되는 걸 막으려고 새로 늘린 앱을 대조군에서 뺐습니다. 맞는 조치였습니다. 그런데 그 앱은 다른 어느 판정에도 안 들어가 있었습니다 — 제외는 오염을 막는 동시에 감시 구멍을 하나 팝니다. 제외할 때마다 자기 행을 만들어야 했습니다.

#gates#preregistration#monitoring#measurement

개념 도식: 세 단계 진동 사다리 중 두 칸만 수정되어 나머지 한 칸이 그대로 남은 구조

배포와 인프라2026-09-156 분 읽기

절반만 고쳤는데 '고쳐졌다'는 보고가 돌아왔습니다

진동이 전혀 안 온다는 신고를 받고 세 곳을 고쳤습니다. 사용자는 '이제 느껴진다'고 했지만, 실제로는 신호 사다리의 두 칸만 고쳐져 있었습니다.

#gotchas#android#verification#debugging

개념 도식: first_open 468 에서 walk_started 164 로 줄어드는 퍼널과 그 사이의 로그인 관문

배포와 인프라2026-09-157 분 읽기

설치의 절반이 로그인 화면에서 사라졌고, 서버는 이미 익명 접근을 허용하고 있었습니다

앱을 켠 468대 중 164대만 걷기를 시작했습니다. 최대 이탈 구간은 로그인이었고, 취소 이벤트가 설치당 여섯 번씩 찍혀 있었습니다.

#reality-check#analytics#android#ios

왼쪽: 생성물에 손으로 넣은 항목이 다음 재생성 때 조용히 교체된다. 오른쪽: 교체 전후 개수가 46으로 같아서 개수 검사로는 못 잡는다

배포와 인프라2026-09-129 분 읽기

손으로 넣은 앱이 목록에서 사라졌는데, 개수는 그대로였습니다

앱 46개짜리 정본 목록에 빠진 앱 하나를 손으로 채워 넣었습니다. 이틀 뒤 그 파일을 재생성했더니 그 앱이 없어지고 대신 다른 앱이 들어와 있었습니다. 여전히 46개였습니다 — 개수를 세는 검사는 이런 교체를 영원히 통과시킵니다.

#shipping-infra#automation-pipeline#gotchas#reality-check

왼쪽은 UA를 위장한 curl이 어떤 봇을 사칭하든 403을 받는 실험, 오른쪽은 원본 access log에 실제 크롤러가 200·200·304를 받았고 403은 0건인 기록

배포와 인프라2026-09-119 분 읽기

봇이 막혔는지 보려고 봇인 척했습니다 — 그 실험은 '막혔다'밖에 답할 수 없었습니다

UA를 바꿔 찔러보는 차단 테스트는 모든 조건에서 403을 돌려줍니다. 엣지가 UA가 아니라 IP로 검증하기 때문입니다. 판정은 원본 access log에서 해야 합니다.

#gotchas#seo#naver#debugging

배포와 인프라2026-09-109 분 읽기

주 3회 도는 잡을 매일 기준으로 감시했습니다 — 경보의 절반이 가짜였습니다

감시판은 잡마다 '기대 주기'를 갖고 산출물 신선도로 판정합니다. 그 주기가 실제 스케줄과 다르면, 안 도는 날마다 지연 경보가 켜집니다.

#monitoring#automation#gotchas#metrics

개념 도식: 같은 한국어 라벨을 단 두 버튼이 각각 기록 저장과 기록 폐기로 이어지는 구조

배포와 인프라2026-09-0910 분 읽기

버리는 버튼과 점령하는 버튼의 한국어가 글자까지 같았습니다

각 함수는 정상이었고 테스트도 통과했습니다. 결함은 어느 함수에 어느 라벨이 붙었는지였습니다. 영어로는 Stop과 End로 겨우 갈렸고, 충돌은 번역에서 태어났습니다.

#android#localization#reality-check#methodology

개념 도식: 같은 날짜에 기기마다 다른 정답이 뽑히는 구조와 해석 순서 수정

배포와 인프라2026-09-0910 분 읽기

데일리 퍼즐인데 기기마다 정답이 달랐습니다

한 모드만 클라이언트가 자기 카탈로그에서 정답을 뽑고 있었습니다. 카탈로그가 갱신되면 풀이 바뀌고, 기기별 pinning이 그 서로 다른 답을 붙들어 뒀습니다. 공유 가능한 데일리가 아니라 개인 퍼즐이었습니다.

#reality-check#verification#methodology#gotchas

개념 도식: 부모 세그먼트의 dynamicParams가 자식 설정을 덮는 구조

배포와 인프라2026-09-089 분 읽기

부모 layout 한 줄이 날짜 페이지 전체를 404로 만들고 있었다

Next.js에서 dynamicParams는 하위 세그먼트로 상속된다. 부모가 false면 자식이 true라고 선언해도 진다. 매일 발행하던 날짜 URL이 사흘 뒤 죽고 있었다.

#nextjs#app-router#seo#routing

Left: the naive fix writes the version back to project.pbxproj only. Right: three places hold a version — pbxproj, the xcodegen seed project.yml, and the store — and each can disagree.

배포와 인프라2026-09-086 분 읽기

버전 되쓰기는 한 줄인 줄 알았습니다 — 진실이 세 곳에 살고 있었습니다

저장소 40개의 버전 거짓말을 고치러 갔습니다. 고치는 코드는 40줄인데, 함정은 두 개였습니다: 빌드가 읽는 파일과 재생성이 읽는 파일이 다르고, '스토어가 진실'이라는 가정도 심사 중인 앱에서는 틀립니다.

#shipping-infra#ios#gotchas#verification

두 패널 도식. 왼쪽은 통화 진입점 맨 앞에서 정리 호출이 실행돼 그 통화가 쓸 이벤트 스트림이 끝나고, 화면에는 타이머가 계속 돌지만 이벤트는 0건이며 에러도 없는 상태를 보여준다. 오른쪽은 통화마다 새 세션을 만드는 형태와, 스트림이 에러 없이 끝났는데 상태가 통화 중이면 실패로 전환하는 방어선을 보여준다.

배포와 인프라2026-09-079 분 읽기

통화를 시작하는 코드가 그 통화가 쓸 스트림을 닫고 있었습니다

심사에서 같은 사유로 두 번 거부됐습니다. 첨부된 스크린샷에는 통화 화면이 정상으로 떠 있었습니다. 타이머도 돌고 종료 버튼도 살아 있는데, 서버에서 오는 이벤트가 0건이었습니다. 에러는 하나도 없었습니다.

#swift#realtime#testing#gotchas

두 패널 도식. 왼쪽은 널 허용 컬럼이 명시적 null을 담고 있어 기본값이 적용되지 않아 디코딩이 실패하고, 실패 핸들러가 프로필 로드 플래그를 되돌려 스피너가 영원히 도는 경로를 보여준다. 오른쪽은 읽기 쪽 강제 설정과 게이트 화면 자체의 실패 표시, 그리고 실테이블만 보는 컬럼 조회를 보여준다.

배포와 인프라2026-09-078 분 읽기

라이브 앱의 신규 가입자는 전부 스플래시에 갇혀 있었습니다

널 허용 컬럼 하나가 신규 사용자의 프로필 로드를 통째로 터뜨렸습니다. 기존 사용자는 멀쩡했으니 신고가 한 건도 없었습니다. 그리고 그 오류를 표시할 자리가 스플래시 화면에는 없었습니다.

#android#kotlin#supabase#gotchas

두 패널 도식. 왼쪽은 내가 편집한 사본으로, HEAD가 8일 전이고 원격 저장소가 없으며 다른 머신의 최신 커밋을 포함하지 않는다. 오른쪽은 실제 정본으로, 같은 날 다른 수익화 설계가 커밋돼 있고 Xcode가 설치돼 있다. 두 저장소는 공통 조상이 없다.

배포와 인프라2026-09-0710 분 읽기

스크린샷에 제가 쓰지 않은 문자열이 찍혀 있었습니다

기능을 다 만들고 빌드도 테스트도 통과했습니다. 마지막에 시뮬레이터 스크린샷을 찍었는데, 화면에 제 코드에 없는 문구가 있었습니다. 저장소 전체 grep 0건. 그 한 줄 때문에 하루치 작업을 전부 폐기했습니다.

#source-of-truth#verification#honesty#shipping

두 패널 도식. 왼쪽은 앱 화면 두 장으로 각각 '연결을 확인하세요'와 '문제가 발생했습니다'라는 문구가 적혀 있고 그 아래 와이파이 아이콘에 초록 체크가 있어 네트워크가 정상임을 표시한다. 오른쪽은 같은 두 실패의 실제 원인으로, 위는 빈 문자열이 들어간 빌드 설정 필드, 아래는 콘솔 목록에 없는 서명 지문이며 각 항목이 왼쪽 화면으로 점선 화살표로 연결된다.

배포와 인프라2026-09-0411 분 읽기

네트워크를 탓하는 에러 메시지 두 개를 열었습니다. 둘 다 네트워크가 아니었습니다

프로덕션 앱의 결제 화면은 '연결을 확인하라'고 했고, 다른 앱의 로그인 화면은 '문제가 발생했다'고 했습니다. 폰은 정상이었습니다. 진짜 원인은 빈 채로 컴파일된 시크릿 하나와, 콘솔에 등록되지 않은 서명 지문 하나였습니다.

#android#gotchas#build#auth

두 패널 도식. 왼쪽은 한 버전·한 로케일의 리스팅 필드 목록으로 description 1913자, keywords 98자, subtitle 27자는 채워져 있고 promotionalText만 0자로 붉게 표시돼 있다. 오른쪽은 계정 전체에서 빈 홍보 문구 칸이 앱 40개에 648칸이라는 표기와 '새 버전마다 다시 비워진다', '심사가 없으니 아무도 검사하지 않는다'.

배포와 인프라2026-09-0413 분 읽기

심사가 안 보는 필드는 아무도 안 봅니다 — 앱 40개에서 홍보 문구 648칸이 비어 있었습니다

앱스토어 리스팅에서 심사 없이 즉시 고칠 수 있는 필드는 promotionalText 하나뿐입니다. 그 필드는 새 버전을 낼 때마다 스스로 비워집니다. 한 앱에서 손으로 채운 지 사흘 만에 다시 비었고, 계정 전체를 세어보니 앱 40개 648칸이 빈 값이었습니다.

#app-store#automation#gotchas#monitoring

가로 파형 두 줄. 위는 스피커로 나가는 앱 목소리, 아래는 마이크로 들어오는 신호인데 위 파형의 축소판이 겹쳐 있음. 아래 파형에 수평 점선 임계가 그어져 있고 점선을 넘는 봉우리 하나에만 '진짜 끼어들기', 점선 아래 잔물결에는 '잔여 에코' 라벨.

배포와 인프라2026-09-0311 분 읽기

앱이 자기 목소리에 끊기고 같은 말을 되풀이했습니다

음성 대화 앱 세 개에서 '가끔 끼어들고 반복한다'는 신고가 왔습니다. 에코 제거는 켜져 있었지만 완벽하지 않았고, 남은 잔여가 서버의 발화 감지 임계를 넘어 앱이 자기 목소리에 끊기고 있었습니다. 실기기 없이 적응형 임계로 맞춘 과정입니다.

#ios#audio#realtime#debugging

진행 표시줄 두 개. 위는 원 두 개짜리이고 오른쪽 저장 버튼이 활성. 아래는 매니페스트 권한 두 줄 때문에 가운데 단계가 하나 끼어 원이 세 개이고, 저장 버튼은 회색으로 죽어 있음.

배포와 인프라2026-09-038 분 읽기

권한 두 줄이 첫 출시를 막았습니다. 저장 버튼조차 안 눌렸습니다

한 번도 출시된 적 없는 앱을 프로덕션에 올리려는데 미리보기에서 저장 버튼이 죽어 있었습니다. 같은 날 다른 앱에서 본 선언 폼은 2단계였는데 이 앱은 3단계였고, 차이는 매니페스트의 권한 두 줄이었습니다.

#android#policy#release#gotchas

왼쪽은 '거부 → 답신(말풍선) → 회색 2시간 구간(변화 없음)'까지, 오른쪽은 '재제출 버튼 → 즉시 심사 대기'로 넘어가는 타임라인

배포와 인프라2026-09-027 분 읽기

심사 회신만으로 재개되는 줄 알았고, 그렇게 두 시간을 버렸습니다

같은 날 앱 두 개가 가격 확인 요청으로 거부됐습니다. 원장엔 '이 유형은 회신만 하면 된다'고 적혀 있었는데, 회신 후 두 시간 동안 상태는 그대로였습니다. 실제 경로는 회신 다음의 수동 재제출이었습니다.

#app-review#ios#gotchas#reality-check

왼쪽은 마이그레이션 파일 아이콘과 잠긴 자물쇠(REVOKE 적힘), 오른쪽은 라이브 DB 아이콘과 열린 자물쇠, 둘 사이 화살표에 '재생성' 라벨. 아래엔 필터 깔때기와 그 옆으로 빠져나가는 문서 아이콘 하나에 'SELECT only' 라벨

배포와 인프라2026-09-028 분 읽기

회수했던 DB 권한이, 어느 재생성에서 조용히 되돌아와 있었습니다

주간 보안 메일은 무해한 항목 하나만 알려줬습니다. API로 전량 214건을 받아보니, 진짜 구멍은 한 단계 낮은 등급 무더기 속에 있었습니다 — 시크릿을 평문으로 돌려주는 내부 함수가 익명 역할에 열려 있었고, 마이그레이션 파일엔 회수 구문이 정확히 적혀 있었는데도요.

#database#security#gotchas#reality-check

Left: ios_release.py appends MARKETING_VERSION=1.9.4 to the xcodebuild command. Right: the committed project file still reads MARKETING_VERSION = 1.0, for all 35 compared apps.

배포와 인프라2026-09-018 분 읽기

제 앱 저장소 40개의 버전 번호가 전부 거짓말이었습니다

릴리스 도구가 xcodebuild에 버전을 커맨드라인으로 넘기고, 저장소에는 되쓰지 않습니다. 스토어엔 1.9.4가 올라가 있는데 project 파일은 1.0인 채로 40번 릴리스됐습니다. 한 번도 안 터진 이유와, 딱 한 번 터진 자리.

#shipping-infra#ios#reality-check#gotchas

같은 앱을 가리키는 두 화면. 왼쪽 앱 목록의 칩은 회색 'Not yet sent for review', 오른쪽 Publishing overview의 배너는 파란 'Changes in review'. 가운데 화살표가 오른쪽을 가리킨다.

배포와 인프라2026-09-017 분 읽기

심사 중인 릴리스를 하마터면 다시 만들 뻔했습니다

앱 두 개가 콘솔 목록에서 며칠째 'Not yet sent for review'였습니다. 같은 날 같은 스크립트로 올린 다른 일곱 개는 전부 'In review'로 바뀌었는데요. 그래서 릴리스를 다시 만들어 재제출하려고 계획을 적어 뒀습니다. 두 화면이 서로 다른 말을 하고 있었고, 제가 믿은 쪽이 틀린 쪽이었습니다.

#android#google-play#gotchas#reality-check

Left panel: a 2,581-byte stylesheet with v1 class names matching none of the live v3 markup. Right panel: a 24KB stylesheet served under a new filename to bypass the edge cache.

배포와 인프라2026-08-3110 분 읽기

페이지 160개가 스타일 없이 서비스되고 있었습니다. 제 브라우저에서만 멀쩡했습니다

repo 전체 미러 업로드가 공용 스타일시트를 넉 달 전 파일로 덮었습니다. 파일은 있었고, 크기만 2.5KB였습니다. 잃어버린 원본은 Chrome 디스크 캐시에서 복구했습니다.

#deployment#gotchas#reality-check#debugging

Left panel: server-rendered HTML contains a hardcoded old headline that a crawler and view-source see. Right panel: the browser swaps in the new headline from a locale object after hydration.

배포와 인프라2026-08-317 분 읽기

구글은 제 앱의 넉 달 전 문구를 색인하고 있었습니다

브라우저에서는 새 문구가 보이는데 검색 결과와 미리보기에는 옛날 문구가 떴습니다. 원인은 하드코딩된 폴백 한 줄과 그와 갈라진 i18n 데이터였습니다.

#gotchas#reality-check#static-sites#debugging

Left panel: Swift reads json["displayName"].stringValue and gets an empty string when the key is absent. Right panel: Kotlin decodes a non-null String field and throws MissingFieldException on the same payload.

배포와 인프라2026-08-317 분 읽기

제 로그인은 한 OS에서만 죽었습니다. 파서가 한쪽에서만 예외를 던졌습니다

같은 로직을 Swift에서 Kotlin으로 그대로 포팅했는데 Android에서만, 그것도 일부 계정만 로그인이 크래시했습니다. 원인은 코드가 아니라 두 언어가 '없는 필드'를 다루는 방식이었습니다.

#gotchas#android#ios#reality-check

왼쪽은 anon EXECUTE가 걸린 삭제 함수 안에 상수로 박힌 운영자 토큰 해시, 오른쪽은 그 해시를 그대로 넣은 공개 REST 호출이 200을 반환하는 장면

배포와 인프라2026-08-288 분 읽기

게시판 전체 삭제 마스터키는, 앱 안에 그냥 박혀 있는 공개 문자열이었습니다

주간 보안 메일엔 이슈 1건만 왔습니다. API로 전체를 받아보니 227건이었고, 진짜 구멍은 메일에 없던 그 안에 있었습니다 — 관리자 삭제 함수에 상수로 박힌 해시 하나면 누구 글이든 지울 수 있었습니다.

#gotchas#reality-check#database#security

왼쪽은 파일당 헤더 6개를 세는 grep 결과, 오른쪽은 여섯 겹 껍질 중 가장 안쪽에만 진짜 법적 원문이 있는 구조

배포와 인프라2026-08-268 분 읽기

제 법적 고지 페이지가 자기 자신을 여섯 겹으로 삼키고 있었습니다

한 앱의 privacy.html에서 헤더가 6번 나오는데 </html>은 1개였습니다. 확인해 보니 41개 앱, 123개 파일 전부 같은 증상이었습니다. "라이브 받아서 고쳐 되올리기"를 반복한 배포 절차가 매 사이클마다 한 겹씩 쌓은 것이었습니다.

#gotchas#reality-check#deployment#verification

왼쪽은 3개 중 2개 컬럼만 되돌리는 v1 검증 블록, 오른쪽은 longest_streak이 0에서 1로 오염된 채 남은 실제 유저 행

배포와 인프라2026-08-268 분 읽기

제 검증 스크립트가 실사용자 데이터를 고치고 하나만 되돌렸습니다

보안 마이그레이션 끝에 넣은 기능 시험이 진짜 유저 행을 건드렸습니다. 되돌리는 코드도 같이 넣었는데, 그 함수가 실제로 바꾸는 필드 세 개 중 하나를 빼먹었습니다.

#gotchas#reality-check#verification#database

왼쪽: 라벨이 신고한 '연결되지 않음' 목록. 오른쪽: 같은 데이터가 계정 외래키와 행수준 보안으로 묶여 있는 스키마.

배포와 인프라2026-08-2411 분 읽기

제 스토어 라벨은 건강 데이터가 당신과 연결되지 않는다고 말하고 있었습니다

앱 스토어 개인정보 라벨에서 건강·이메일·User ID가 전부 "연결되지 않음"으로 신고돼 있었습니다. 스키마에는 모든 로그 테이블에 계정 외래키가 걸려 있습니다. 결정적 증거는 Apple 자신의 마법사 문구였습니다.

#app-store#privacy#ios#gotchas

왼쪽: 기본 스토어 API 응답이 total 4에 items 빈 배열이라 미게시처럼 보인다. 오른쪽: includeUnrunnableActors 플래그를 붙이면 같은 질의가 4개를 전부 돌려준다.

배포와 인프라2026-08-2211 분 읽기

"게시됨"이라고 적혀 있었는데, 검색엔 3일째 안 나왔습니다

마켓플레이스 API가 total 4를 주면서 items는 빈 배열을 줬습니다. 저는 그걸 '아직 게시가 안 됐다'로 읽고 로고를 만들고 있었습니다. 실제로는 이미 색인돼 있었고, 기본 응답에서 조용히 걸러지고 있었을 뿐입니다.

#api#gotchas#reality-check#measurement

배포와 인프라2026-08-1911 분 읽기

공개 버튼을 누르기까지 네 번 막혔고, 다섯 번째는 아무 말도 안 했습니다

마켓플레이스에 도구 하나 올리는 데 플랫폼이 네 번 거절했습니다. 전부 명확한 에러 메시지를 줬으니 싼 문제였습니다. 정작 위험했던 다섯 번째는 아무것도 실패시키지 않았습니다 — 무료 공개 도구에 내 API 키를 얹었다는 사실 자체였습니다.

#gotchas#shipping#marketplace#reality-check

1080x1920에서 25.8초, 720x1280으로 낮춰도 25.4초. 픽셀을 44%로 줄였는데 시간은 1.5%만 줄었다. 배압을 setTimeout에서 encoder.ondequeue로 바꾸자 1080x1920 그대로 1.17초.

배포와 인프라2026-08-198 분 읽기

픽셀을 절반으로 줄였는데 1초도 안 빨라졌습니다

8초짜리 영상 하나를 만드는 데 25.8초가 걸렸습니다. 해상도를 1080×1920에서 720×1280으로 낮췄더니 25.4초가 나왔습니다. 그 0.4초가 병목이 어디 있는지 알려줬습니다.

#performance#webview#debugging#first-principles

startActivity(chooser)는 선택 UI를 띄울 뿐이고 수신 앱은 사용자가 대상을 고른 뒤에 FileProvider URI를 연다. 그 사이 파일을 지우면 FileNotFoundException이 나고 우리 앱에는 아무 신호도 오지 않는다.

배포와 인프라2026-08-197 분 읽기

공유한 영상이 첨부되지 않았습니다 — 제가 방금 지웠거든요

안드로이드에서 공유 시트를 띄운 직후 임시 파일을 정리했습니다. 깔끔한 코드처럼 보였고, 프로덕션에 나갔고, 영상 공유는 전부 조용히 실패하고 있었습니다.

#android#gotchas#reality-check#shipping

배포와 인프라2026-08-1913 분 읽기

회색으로 잠긴 버튼이 원한 건 웹사이트였습니다. 그 말은 툴팁에만 있었습니다

스토어에 뜨는 개발자 이름을 사업자명으로 바꾸려고 했습니다. 바꾸려던 필드는 처음부터 열려 있었고, 잠겨 있던 건 옆에 있던 다른 버튼이었습니다. 잠금 조건은 화면 본문 어디에도 없고 물음표 아이콘 툴팁 한 줄에만 적혀 있었습니다. 조건은 몇 년째 갖고 있던 도메인이었습니다.

#gotchas#reality-check#google-play#android

배포와 인프라2026-08-198 분 읽기

테스트 200개가 통과했고, 버튼은 아무것도 하지 않았습니다

영상은 실제로 만들어졌습니다. 두 플랫폼에서 mp4 바이트까지 확인했고 웹은 이미 프로덕션에 올렸습니다. 그런데 iOS에서 자랑하기를 누르면 아무 일도 일어나지 않았습니다.

#testing#verification#ios#reality-check

왼쪽은 지원 로케일 경로가 전부 200을 반환해 정상으로 보이는 상태, 오른쪽은 미지원 로케일이 404 대신 500을 반환하고 한 앱에서는 가장 흔한 두 로케일이 깨진 쪽이었던 상태

배포와 인프라2026-08-178 분 읽기

제 앱 10개가 크롤러에게 500을 주고 있었습니다 — 브라우저로는 절대 안 보입니다

미지원 로케일 경로에서 404가 아니라 500이 났습니다. 제가 열어보는 경로는 전부 200이라 1년 가까이 몰랐고, 한 앱은 하필 /ko/와 /en/이 깨진 쪽이었습니다. 43개 호스트를 전수 스윕해서 정확히 몇 개인지 셌습니다.

#shipping-infra#nextjs#seo#reality-check

왼쪽은 서울 엣지에서 미국 동부 함수까지 갔다 오며 2.2초가 걸리는 상태, 오른쪽은 서울 엣지가 미리 만들어둔 페이지를 0.13초에 내주는 상태

배포와 인프라2026-08-1711 분 읽기

제 블로그는 방문자마다 태평양을 건너고 있었습니다 — 원인은 `<html lang>` 한 줄

무료 한도 75% 경고가 왔습니다. 엣지 헤더를 훑어 범인을 지목했는데, 대시보드를 보니 제가 지목한 앱은 목록에 없었습니다. 진짜 원인은 루트 레이아웃의 headers() 한 번이었고, 그것 때문에 239개 페이지가 요청마다 미국에서 렌더되고 있었습니다.

#shipping-infra#gotchas#reality-check#first-principles

왼쪽 패널은 앱이 이미 작명·태명·이름풀이·상호명 중심으로 바뀐 상태, 오른쪽 패널은 스토어 리스팅이 여전히 astrology와 fortune teller 키워드에 첫 문장이 운세 허브라 4.3(b) 리젝을 부른 상태

배포와 인프라2026-08-169 분 읽기

앱은 이미 바꿨는데 리젝당했습니다 — 리뷰어가 읽은 건 앱이 아니라 리스팅이었습니다

4.3(b) 포화 카테고리로 리젝됐습니다. 앱 첫 화면은 이미 작명이었지만 스토어 키워드는 여전히 astrology·fortune teller였고 5개 로케일 설명 첫 문장은 '운세 허브'였습니다. 고친 건 코드가 아니라 텍스트였습니다.

#app-store#shipping-infra#reality-check#first-principles

왼쪽 패널은 티켓이 지목한 결제 경로가 charge·receipt·entitlement·webhook 전부 OK였음을, 오른쪽 패널은 가입 트리거가 (id, stage) 행을 먼저 만들어 앱이 row != nil을 온보딩 완료로 읽었고 가입자 651명 중 646명의 selected_symptoms가 빈 배열이었음을 보여준다

배포와 인프라2026-08-1418 분 읽기

"돈은 빠져나갔는데 앱이 비어 있어요" — 결제는 처음부터 문제가 아니었습니다

구독자가 앱이 비어 있다고 신고했습니다. 결제·영수증·권한은 전부 정상이었습니다. 원인은 가입 트리거가 만든 '완성처럼 보이는 빈 행'과 앱의 `!= nil` 한 줄이었습니다. 실측 결과 가입자 651명 중 646명이 온보딩을 건너뛴 상태였습니다.

#supabase#postgres#onboarding#reality-check

왼쪽은 배포된 것 - 게임 6개, 초록 테스트, TLS 200, 계측 이벤트 발화. 오른쪽은 그 게임들을 링크한 것 - 허브 카드 0, 매니페스트 0, 숏폼 파이프라인 0, 외부 방문자 0

배포와 인프라2026-08-1318 분 읽기

웹앱 게임 6개를 스크래치부터 배포까지 올렸습니다. 어느 페이지도 그 게임들을 링크하고 있지 않았습니다

테스트 통과, 빌드 통과, 커스텀 도메인 TLS 200, 계측 이벤트 적재까지 전부 확인했습니다. 다음 날 외부 방문자를 세어보니 0명이었습니다. grep 두 번으로 원인이 나왔습니다. 게임 품질이 아니었습니다.

#gotchas#reality-check#deployment#first-principles

두 패널 비교 도식. 왼쪽은 제안서가 약속한 것(통신·카드·내비 빅데이터로 관광지별 시간대 혼잡도), 오른쪽은 개방 API가 실제로 주는 것(시군구 월별 방문자, 관광지 일별 집중률, 시간대 없음). 아래에 출시 빌드가 그 빈칸을 Math.random()으로 채우고 있었다는 코드 한 줄.

배포와 인프라2026-08-1129 분 읽기

제안서에 약속한 데이터는 존재하지 않았다

공공 관광 데이터 공모전에 앱을 냈습니다. 제안서에 쓴 시간대별 혼잡도 데이터는 개방 API에 없었고, 앱에는 이미 그 차트가 Math.random()으로 그려지고 있었습니다. 제안서에서 구현, 심사, 제출까지 4개월 반 동안 나온 함정 전부.

#public-data#api#locale#deployment

왼쪽은 주간 봇 잡 세 개가 모두 success인 목록, 오른쪽은 같은 기간 라이브 사이트의 sitemap이 2주 전에 멈춰 있는 모습

배포와 인프라2026-08-109 분 읽기

워크플로는 2주 내내 초록불이었고, 사이트는 2주 내내 낡아 있었습니다

주간 수집 봇이 매주 성공했습니다. 제품 60개가 늘었고 페이지 692개가 빌드됐습니다. 그런데 라이브 사이트는 07-27에 멈춰 있었습니다.

#ci-cd#automation#gotchas#deployment

개념 도식: 퍼널 맨 위 칸에 사람 아이콘 여러 개 중 두 개가 돋보기 아이콘. 아래 칸으로 갈수록 사람이 줄고 돋보기는 첫 칸에 멈춰 있음.

배포와 인프라2026-08-108 분 읽기

앱 심사원이 내 퍼널에 신규 유저로 집계됐다

제출 5분 뒤, 아직 공개되지 않은 버전에서 두 대의 기기가 앱을 열었습니다. 심사 기기는 신규 유저와 구별되지 않고, 하필 측정하려던 지표를 아래로만 끌어내립니다. 걸러내는 대신 드러내기로 했습니다.

#app-store#analytics#ios#android

개념 도식: 왼쪽 터미널에 total 0이 다섯 줄, 오른쪽 브라우저에 리뷰 카드 3장. 가운데에 '같은 리뷰'.

배포와 인프라2026-08-109 분 읽기

리뷰가 사라졌다고 두 번 보고했다. 둘 다 틀렸다

리뷰 DB가 7주 멈춰 있었습니다. 수집기 고장이라고 보고했다가 틀렸고, 애플이 27건을 제거했다고 보고했다가 또 틀렸습니다. 브라우저를 한 번 열어보니 리뷰는 전부 그대로 있었습니다. API가 자기 데이터를 안 돌려주고 있었을 뿐입니다.

#app-store#api#supabase#reality-check

개념 도식: 초록 체크가 줄줄이 찍힌 테스트 러너에서 화살표가 빠져나와 프로덕션 DB로 들어가고, DB 옆에 '유저 6명 (존재하지 않음)'.

배포와 인프라2026-08-109 분 읽기

테스트를 전부 통과시켰더니 프로덕션에 유저가 생겼다

첫 세션 퍼널 계측을 붙이고 184개 테스트를 통과시켰습니다. 확인 삼아 서버 테이블을 조회하니 배포도 안 한 계측이 프로덕션에 6행을 써놓았습니다. 테스트를 통과시키는 행위 자체가 측정 대상을 바꾸고 있었습니다.

#ios#android#testing#analytics

개념 도식: 왼쪽은 중복 제거라는 목표, 오른쪽은 정본 27,531바이트 옆에 새로 만든 1,086바이트 사본

배포와 인프라2026-08-099 분 읽기

중복을 지우러 갔다가 중복을 하나 더 만들었습니다

서브도메인 일곱 개를 한 경로로 통일하는 30분짜리 정리 작업이었습니다. 그 과정에서 백업으로 살려 낸 사이트가 알고 보니 이미 다른 경로에 정본으로 살아 있었고, 제가 올린 건 25배 작은 구버전이었습니다.

#gotchas#seo#deployment#reality-check

개념 도식: 왼쪽은 서브도메인 7개를 한 경로로 합친 정리 작업, 오른쪽은 그 때문에 조용히 깨진 소유권 확인 3건

배포와 인프라2026-08-0910 분 읽기

리다이렉트 한 줄이 구글에 대한 소유권을 지웠습니다

사이트 7개를 한 경로로 합치고 서브도메인은 301만 남겼습니다. 배포도 검증도 깨끗했는데, 며칠 뒤 Search Console이 '소유권 확인 실패'를 띄웠습니다. 확인 메타태그가 제가 리다이렉트해 버린 그 페이지에 살고 있었습니다.

#gotchas#seo#search-console#dns

개념 도식: 한국어 휴대폰 요청의 Accept-Language 헤더가 locale detector를 거쳐 /ko로 리다이렉트되고, html lang=ko와 모바일 KO/EN 전환 버튼으로 검증되는 흐름

배포와 인프라2026-08-087 분 읽기

한국어 폰인데 devlog 첫 화면이 영어였다

한국어로 설정된 휴대폰에서 dev.ootssu.com의 첫 화면이 영어로 열렸습니다. 글 번역 문제가 아니라 라우팅, 문서 lang, 모바일 전환 버튼이 동시에 만든 i18n 운영 버그였습니다. Accept-Language를 제대로 파싱하고, /ko 문서는 lang=ko로 렌더하고, 모바일에서도 언어 전환 버튼을 보이게 고쳤습니다.

#i18n#nextjs#locale#mobile

개념 도식: 브라우저 세션 기반 주문 모니터에서 공식 커머스API 백엔드로 전환

배포와 인프라2026-08-0810 분 읽기

브라우저를 조종하던 주문봇을 공식 API로 갈아탔다 — 그리고 일부러 자동화하지 않은 것

AppleScript로 브라우저 세션을 조종하던 주문 모니터를 공식 커머스API로 옮겼습니다. bcrypt 서명 인증, launchd 상시 운영, 그리고 환불·반품을 끝까지 자동 승인하지 않은 이유.

#automation#api#launchd#gotchas

배포와 인프라2026-08-0812 분 읽기

서치콘솔이 404 메일을 퍼부었다. 로그를 보니 범인은 내 코드가 아니었다

구글 서치콘솔이 'Not found (404)' 메일을 수십 통 쏟아냈습니다. 사이트를 고치려다, 대시보드 대신 서버 로그를 봤습니다. 사이트맵 149개 전부 멀쩡, 내부 링크도 멀쩡, 검색봇이 실제로 404를 낸 URL은 전 로그 통틀어 딱 하나였습니다. 나머지는 전부 외부 유령이었습니다.

#first-principles#reality-check#seo#infra

개념 도식: completed 100%·listing saved·commit ok 초록 체크 셋이 쌓여 있는데, 앱 상태는 REJECTED이고 유저 기기엔 이전 버전이 떠 있다. completed는 트랙 배정이지 서빙이 아니다.

배포와 인프라2026-08-078 분 읽기

completed 100%는 게시가 아니다

Android 릴리스를 API로 자동화하고 'completed 100%'면 배포 완료로 기록했습니다. 어느 날 리젝 메일이 왔는데 트랙 상태는 여전히 completed였습니다. API는 '트랙에 배정됐다'를 말할 뿐 '사람들이 받고 있다'를 말하지 않습니다. 데이터 보안 양식은 아예 API로 손댈 수도 없습니다.

#android#google-play#api#gotchas

개념 도식: 진단 빌드에선 배너가 100% 뜨고 정상 빌드에선 100% 안 뜬다. 빈 body → row 없음 → .task 안 돎 → 영원히 빈 상태로 순환.

배포와 인프라2026-08-0710 분 읽기

진단 코드를 넣으면 버그가 사라졌다

TestFlight에서만 안 뜨는 배너를 4시간 쫓았습니다. Debug/Release도, 서명도, 실기기도 범인이 아니었습니다. 범인은 제가 원인을 보려고 넣은 진단 코드 그 자체였습니다. 관측 장치가 관측 대상을 바꾸고 있었습니다.

#swiftui#ios#debugging#gotchas

개념 도식: 왼쪽은 테스트 모드에서 refresh token이 7일마다 만료돼 채널이 순차로 죽는 그림, 오른쪽은 프로덕션 게시 후 무기한이지만 소급되지 않는다는 단서

배포와 인프라2026-08-078 분 읽기

내 유튜브 토큰이 매일 하나씩 죽었다 — OAuth '테스트' 모드의 7일 시한폭탄

채널 토큰이 하루에 하나씩 순차로 죽었습니다. 재발급 지옥(PKCE 불일치, 똑같은 이름의 브랜드 계정 여섯 개)을 지나 1원칙으로 근본을 찾으니, '재발급하면 됨'은 값싼 수정처럼 보이는 함정이었습니다. 진짜 원인은 OAuth 동의 화면의 게시 상태였습니다.

#oauth#youtube-api#tokens#gotchas

개념 도식: 서버 200 → JSON "2026-07-01" → ISO8601 디코더가 행 전체 throw → catch가 빈 배열 → 빈 화면. 앞 단계는 전부 초록 체크, 마지막만 빈 사각형.

배포와 인프라2026-08-076 분 읽기

date 컬럼 하나가 화면 전체를 지웠다

지역 비교 카드가 통째로 사라졌습니다. 에러도 없고, RPC는 200이고, 데이터도 들어 있는데 화면만 비었습니다. 표시에 쓰지도 않는 date 필드 하나의 디코딩 실패가 decode 전체를 throw시켰고, catch가 빈 배열로 떨어졌습니다. 어느 단계에서도 빨간불이 안 켜집니다.

#ios#supabase#swift#gotchas

개념 도식: 대시보드엔 제각각인 entitlement ID가 늘어서 있고 코드는 'pro' 하나만 조회. 선이 딱 하나만 연결되고 나머지는 결제 성공·영수증 정상·에러 없음인데 끊겨 있다.

배포와 인프라2026-08-077 분 읽기

결제는 됐는데 Pro가 안 켜졌다

영수증도 정상, 서버도 정상, 에러도 없는데 앱만 계속 free였습니다. 범인은 이름이었습니다. RevenueCat이 앱 이름 기반으로 entitlement를 자동 생성하는데, 코드는 'pro' 하나만 보고 있었습니다. 그리고 이 버그는 예외도 로그도 없이 조용히 실패합니다.

#ios#revenuecat#iap#gotchas

개념 도식: sealed class + data object 구조에서 keep rule 화살표는 child에 꽂히는데 R8의 가위는 base class에서 route를 자른다. enum으로 바꾸면 R8이 필드를 자동 보존해 keep rule 자체가 불필요.

배포와 인프라2026-08-076 분 읽기

R8이 route 필드를 반복해서 지웠다

Android release 빌드가 세 버전에 걸쳐 같은 NPE로 죽었습니다. keep rule을 계속 넓혔고, 한 번은 잠잠해졌다가 다시 회귀했습니다. keep rule이 안 먹은 게 아니라, keep이 걸린 위치와 R8이 자르는 위치가 달랐습니다. 정답은 keep이 아니라 패턴을 바꾸는 것이었습니다.

#android#r8#kotlin#gotchas

개념 도식: reviewSubmission 껍데기가 REJECTED 상품 6개를 가두고 있고, 밖에서 appStoreVersion을 PREPARE_FOR_SUBMISSION으로 바꾸는 화살표가 튕겨 나온다. 껍데기를 취소하는 화살표 하나만 안쪽에 닿아 상품이 자동 복귀.

배포와 인프라2026-08-078 분 읽기

`version not editable`의 주체는 버전이 아니었다

심사 리젝 후 상품 현지화를 고치려는데 409 'version is not editable'가 났습니다. 그래서 버전을 편집 가능하게 만들었더니 같은 409. 에러가 말하는 'version'은 appStoreVersion이 아니라, 아직 열려 있는 reviewSubmission 껍데기였습니다. App Store Connect API 함정 시리즈 1편.

#app-store-connect#api#ios#gotchas

개념 도식: 화면은 줌아웃마다 4배로 커지는데 조회 박스는 ±0.05°로 고정. z11에선 박스가 화면 안쪽에 완전히 갇힌다. 박스 밖은 '아직 안 옴'이 아니라 '요청조차 안 됨'.

배포와 인프라2026-08-078 분 읽기

지도를 축소했더니 남의 영토가 사라졌다

지도를 축소하면 다른 유저의 영토가 안 보이고 버벅였습니다. 로딩이 느린 것처럼 보였는데, 기다려도 안 채워졌습니다. 조회 범위가 고정 bbox였습니다 — 화면은 줌마다 4배가 되는데 요청 범위는 그대로라, 어느 줌 아래로는 화면 가장자리가 서버에 요청조차 되지 않았습니다.

#android#supabase#postgis#gotchas