이 글은 Today I Learn 시리즈의 157번째 기록입니다. (총 213개)

파일이 없을 때 조용히 실패하지 않는다는 걸 이틀에 걸쳐 두 번 배웠다.


없는 것과 틀린 것

빈 자리가 엉뚱한 답을 돌려준다

정적 호스팅은 파일이 없는 주소를 요청받으면 오류 대신 홈 화면을 정상 응답으로 돌려주기도 한다. 이틀 새 같은 함정에 두 번 걸렸다.

한 번은 내려 둔 소개 페이지가 멀쩡히 열렸다. 지웠는데 왜 열리나 싶었는데 그 자리에 홈 내용이 오고 있었다. 또 한 번은 광고 인증 파일을 안 올린 상태에서, 광고 쪽이 그 주소를 읽고 홈 화면을 인증 파일로 해석해 “파일은 있는데 내용이 맞지 않는다”고 진단했다. 없는 것보다 헷갈리는 상태다.

여기서 얻은 판단은 이렇다. 무언가를 내리거나 새로 올렸으면 배포 뒤에 그 주소를 직접 열어 본다. 성공 신호만 보면 안 되고 내용이 기대한 것인지까지 봐야 한다. 시스템이 빈손을 조용히 넘기지 않고 그럴듯한 오답을 내놓을 수 있다는 걸 전제로 확인한다.

잠시 닫는 것과 영영 닫는 것은 신호가 다르다

페이지를 내릴 때 무엇으로 응답할지 고를 수 있고, 셋의 뜻이 다르다.

  • 없다고 답하기 — 검색엔진이 색인에서 지운다. 다시 열 계획이면 그동안 쌓은 노출을 버리는 셈이다
  • 주소가 바뀌었다고 답하기 — 색인이 새 주소로 넘어간다. 되돌려도 원래대로 돌아오는 데 시간이 걸린다
  • 잠깐 다른 곳을 보라고 답하기 — 원래 주소를 계속 들고 있는다

출시 대기처럼 곧 되살릴 페이지는 세 번째가 맞다. 며칠 닫는 일에 첫 번째나 두 번째를 쓰면, 문 여는 날 검색에서 다시 시작하게 된다.

한 가지 더. 닫는 규칙의 범위를 넓게 잡으면 그 아래 있는 주소까지 함께 끊긴다. 소개 페이지와 방침이 같은 폴더에 있으면, 폴더째 닫는 순간 앱에 박힌 방침 주소도 죽는다.


광고가 붙는 앱의 도메인

재고 판매 권한을 도메인으로 증명한다

광고가 붙은 앱은 “이 앱의 광고를 팔 권한이 누구에게 있는가”를 개발자 웹사이트로 증명한다. 스토어에 적힌 웹사이트를 광고 쪽이 찾아와 그 도메인에 놓인 선언 파일을 읽는 구조다.

알아 둘 것은 셋이다.

  1. 계정 단위라 파일 한 줄이면 그 계정의 모든 앱이 커버된다. 앱이 늘어도 그대로 둔다
  2. 위치가 도메인 최상단이어야 한다. 하위 경로에 두면 못 찾는다
  3. 없으면 실제로 손해다. 일부 광고 구매자가 인증 안 된 재고를 입찰에서 제외한다

세 번째가 중요한 이유는 원인 구분이 어렵기 때문이다. 신규 앱은 원래도 광고가 잘 안 붙는 시기라, 인증이 빠진 탓인지 앱이 작아서인지 구분이 안 된다. 그래서 이건 나중에 확인할 일이 아니라 출시 전에 해 둘 일이다.

또 하나, 스토어에 적은 웹사이트 주소와 파일을 올린 도메인이 같아야 한다. 이건 콘솔 설정이라 코드에서 확인할 방법이 없어서, 확인했으면 어딘가에 적어 둬야 다시 묻지 않는다.


검색에 알리기

링크로 닿지 않는 페이지는 존재해도 발견되지 않는다

검색 크롤러는 링크를 따라다니며 페이지를 찾는다. 그래서 사이트 안에서 아무도 링크하지 않는 페이지는 있어도 없는 것과 같다.

우리 샵이 딱 그랬다. 페이지가 스물두 개인데 홈에서 링크로 닿는 건 제품 셋뿐이고, 제품별 방침·약관 열두 개는 앱과 스토어에서만 쓰는 주소라 사이트 어디에서도 링크되지 않는다.

목록 파일 하나로 “이 사이트에 이런 주소들이 있다”를 넘기면 이 구멍이 메워진다. 링크 구조에 의존하지 않고 알리는 방법이 따로 있다는 걸 알게 된 게 소득이다.

언어별 페이지가 있으면 목록에 그 관계도 같이 담는다. 그래야 영어판과 한국어판이 중복 콘텐츠가 아니라 한 쌍으로 이해되고, 방문자 언어에 맞는 쪽이 결과에 나온다.

규칙 파일은 없는 것보다 잘못 있는 게 나쁘다

크롤러에게 주는 규칙 파일도 같은 함정을 만났다. 파일을 안 올린 상태에서 그 주소를 열면 홈 화면이 정상 응답으로 온다. 크롤러는 그걸 규칙으로 읽으려다 실패한다.

그래서 올린 뒤에는 형식까지 확인한다. 브라우저에 그럴듯한 화면이 나오는 것과, 기계가 읽을 형식으로 나오는 것은 다른 문제다.

검색 콘솔에 직접 제출하는 것은 별개다. 두면 언젠가 발견되지만, 제출하면 색인 상태와 오류를 화면으로 볼 수 있어 문제를 빨리 안다.


만든 것을 다시 쓰기

스토어용으로 만든 이미지를 사이트에 그대로 쓴다

앱 등록용 소개 이미지는 사이트에서도 쓸 수 있다. 다시 만들지 않는 편이 낫다 — 두 벌이 되면 문구가 갈라지고, 어느 쪽이 최신인지 알 수 없게 된다.

세 가지를 배웠다.

  • 한국어와 영어 문구가 함께 박힌 이미지는 두 언어 페이지에 그대로 쓸 수 있다. 대체 텍스트만 갈라 주면 된다
  • 이미 기기 화면 모양으로 만들어진 이미지에는 액자를 덧대지 않는다. 프레임 안에 프레임이 된다
  • 스토어용 원본은 무겁지만 웹으로 내보낼 때 자동으로 줄어든다. 장당 1MB짜리가 30KB 아래로 떨어졌다

반영이 안 된 것처럼 보일 때 무엇을 먼저 가를까

광고 인증 파일을 사이트 맨 위 경로에 올리고 바로 열어 봤는데 옛 내용이 그대로 왔다. 파일이 잘못 올라갔나 싶어 다시 만지고 싶어지는 자리다. 이때 코드를 의심하기 전에 두 가지를 가른다. 배포가 아직 안 끝났는가, 아니면 응답이 중간 어딘가에 저장돼 있는가.

가르는 방법은 호스팅이 주는 원래 주소로 직접 열어 보는 것이다. 거기서 새 내용이 보이면 중간 어딘가에 옛 응답이 남아 있는 것이고, 거기서도 옛 내용이면 아직 배포가 안 끝난 것이다.

이 구분을 못 하면 멀쩡한 코드를 고치러 간다. 실제로 이번 건은 잠시 기다리면 되는 상황이었다.


Series: Today I Learn

1 C++ 자료형(Data Type) 2 MD5 vs pHash 3 C++에서 함수의 선언과 정의 4 Tkinter padx, pady 5 메모리와 포인터 변수 6 Call by Value, Call by Reference, Call by Pointer 비교 7 const 8 Gemfile — Jekyll 프로젝트의 의존성 파일 9 kramdown-parser-gfm — Jekyll의 GFM 파서 10 파서(Parser) 11 AHU vs OHU 12 I might try it vs I'll try it 뉘앙스 차이 13 SESSION_EXPIRE_AT_BROWSER_CLOSE=True 14 configuration key 15 Git stash vs discard 16 subprocess.Popen으로 Windows 탐색기에 명령어를 전달 17 Post 잔디 분석하기 18 Google Sheets Sync 최적화 19 DSL (Domain Specific Language)과 GPL (General Purpose Language) 20 마크다운 표 그리는 방법 21 쿼리 파라미터(Query Parameter). 기존 QR코드 재활용 22 Django 보안 취약점 점검 및 수정 23 OOP Object-Oriented Programming 객체 지향 프로그래밍 24 Fernet 대칭 암호화 25 Jekyll 코드블록 안의 Liquid 태그 26 습관만들기 Pawbit TIL 1 27 insertOnConflictUpdate vs DoUpdate(target) 28 세션 필터 29 아코디언(Accordiaon) UI를 펼친상태로 만들기 30 input의 step 31 습관만들기 Pawbit TIL 2 32 습관만들기 Pawbit TIL 3 33 Word Cloud 34 Google Sheets를 데이터 버스로(with AppSheet) 35 Django 모델 텍스트 필드 자동 수집 패턴 36 localStorage로 섹션 토글 상태 유지 37 순차 ID 생성(`select_for_update()` + `max()` 조합) 38 역참조 검색과 distinct() 39 xlsx 다운로드와 로딩 오버레이 충돌 40 Android 파일 공유 MIME 타입 41 AssetManifest — Flutter 빌드 타임 asset 목록 런타임 조회 42 크레센도 Phaser + TypeScript TIL 1 43 크레센도 Phaser + TypeScript TIL 2 44 크레센도 Phaser + TypeScript TIL 3 45 크레센도 Phaser + TypeScript TIL 4 46 크레센도 Phaser + TypeScript TIL 5 47 여둘까 Office Layout TIL 1 48 습관만들기 Pawbit TIL 4 49 여둘까 Office Layout TIL 2 50 여둘까 Office Layout TIL 3 51 크레센도 Phaser + TypeScript TIL 6 52 UTF-8 BOM과 PowerShell 파일 쓰기 53 소리꽃 KeyBloom TIL 1 54 습관만들기 Pawbit TIL 5 55 여둘까 Office Layout TIL 4 56 소리꽃 KeyBloom TIL 2 57 소리꽃 KeyBloom TIL 3 58 메트로놈 Simple Metronome TIL 1 59 소리꽃 KeyBloom TIL 4 60 메트로놈 Simple Metronome TIL 2 61 소리꽃 KeyBloom TIL 5 62 습관만들기 Pawbit TIL 6 63 크레센도 Phaser + TypeScript TIL 7 64 메트로놈 Simple Metronome TIL 3 65 소설 타임라인 관리 도구 Lumior TIL 1 66 습관만들기 Pawbit TIL 7 67 정적 블로그 SEO 정비와 Pagefind 검색 도입 68 크레센도 Phaser + TypeScript TIL 8 69 메트로놈 Simple Metronome TIL 4 70 습관만들기 Pawbit TIL 8 71 안드로이드 AudioTrack 연속 재생, 실측 피커 정렬, 카메라 토치 플래시 72 메트로놈 Simple Metronome TIL 5 73 모래게임 Sandrop TIL 1 74 습관만들기 Pawbit TIL 9 75 메트로놈 Simple Metronome TIL 6 76 모래게임 Sandrop TIL 2 77 모래게임 Sandrop TIL 3 78 습관만들기 Pawbit TIL 10 79 습관만들기 Pawbit TIL 11 80 메트로놈 Simple Metronome TIL 7 81 모래게임 Sandrop TIL 5 82 모래게임 Sandrop TIL 4 83 습관만들기 Pawbit TIL 12 84 모래게임 Sandrop TIL 6 85 소리꽃 KeyBloom TIL 6 86 모래게임 Sandrop TIL 7 87 모래게임 Sandrop TIL 8 88 소리꽃 KeyBloom TIL 7 89 모래게임 Sandrop TIL 9 90 소리꽃 KeyBloom TIL 8 91 모래게임 Sandrop TIL 10 92 소리꽃 KeyBloom TIL 9 93 콘티온 ContiOn TIL 1 94 소리꽃 KeyBloom TIL 10 95 콘티온 ContiOn TIL 2 96 습관만들기 Pawbit TIL 13 97 콘티온 ContiOn TIL 3 98 모래게임 Sandrop TIL 11 99 소리꽃 KeyBloom TIL 11 100 여둘까 Office Layout TIL 5 101 모래게임 Sandrop TIL 12 102 모래게임 Sandrop TIL 13 103 콘티온 ContiOn TIL 4 104 모래게임 Sandrop TIL 14 105 소리꽃 KeyBloom TIL 12 106 습관만들기 Pawbit TIL 14 107 모래게임 Sandrop TIL 15 108 모래게임 Sandrop TIL 16 109 소리꽃 KeyBloom TIL 13 110 온실 GreenHouse TIL 1 111 콘티온 ContiOn TIL 5 112 모래게임 Sandrop TIL 17 113 소리꽃 KeyBloom TIL 14 114 온실 GreenHouse TIL 2 115 콘티온 ContiOn TIL 6 116 모래게임 Sandrop TIL 18 117 콘티온 ContiOn TIL 7 118 모래게임 Sandrop TIL 19 119 소리꽃 KeyBloom TIL 15 120 모래게임 Sandrop TIL 20 121 모래게임 Sandrop TIL 21 122 소리꽃 KeyBloom TIL 16 123 소리꽃 KeyBloom TIL 17 124 소리꽃 KeyBloom TIL 18 125 여둘까 Office Layout TIL 6 126 소리꽃 KeyBloom TIL 19 127 소리꽃 KeyBloom TIL 20 128 콘티온 ContiOn TIL 8 129 콘티온 ContiOn TIL 9 130 로그스톤 상표 셀프 출원 TIL 1 131 소리꽃 KeyBloom TIL 21 132 로그스톤 샵 LogStone Shop TIL 1 133 소리꽃 KeyBloom TIL 22 134 로그스톤 샵 LogStone Shop TIL 2 135 소리꽃 KeyBloom TIL 23 136 모래게임 Sandrop TIL 22 137 모래게임 Sandrop TIL 23 138 소리꽃 KeyBloom TIL 24 139 로그스톤 샵 LogStone Shop TIL 3 140 모래게임 Sandrop TIL 24 141 소리꽃 KeyBloom TIL 25 142 모래게임 Sandrop TIL 25 143 MiniMacro TIL 1 144 모래게임 Sandrop TIL 26 145 콘티온 ContiOn TIL 10 146 Astro가 무엇인지, 왜 옮기는지 147 모래게임 Sandrop TIL 27 148 소리꽃 KeyBloom TIL 26 149 MiniMacro TIL 2 150 로그스톤 샵 LogStone Shop TIL 4 151 메트로놈 Simple Metronome TIL 8 152 모래게임 Sandrop TIL 28 153 여둘까 Office Layout TIL 7 154 메트로놈 Simple Metronome TIL 9 155 블로그 Astro 이관 TIL 156 여둘까 Office Layout TIL 8 157 로그스톤 샵 LogStone Shop TIL 5 읽는 중 158 모래게임 Sandrop TIL 29 159 오픈데이 Openday TIL 1 160 로그스톤 샵 LogStone Shop TIL 6 161 모래게임 Sandrop TIL 30 162 오픈데이 Openday TIL 2 163 모래게임 Sandrop TIL 31 164 Unreal Engine MCP TIL 1 165 모래게임 Sandrop TIL 32 166 소리꽃 KeyBloom TIL 27 167 콘티온 ContiOn TIL 11 168 오픈데이 Openday TIL 3 169 로그스톤 샵 LogStone Shop TIL 7 170 모래게임 Sandrop TIL 33 171 소리꽃 KeyBloom TIL 28 172 오픈데이 Openday TIL 4 173 여둘까 Office Layout TIL 9 174 오픈데이 Openday TIL 5 175 ScorePlayer TIL 1 176 모래게임 Sandrop TIL 34 177 BuildingHub TIL 1 178 ScorePlayer TIL 2 179 여둘까 Office Layout TIL 10 180 BuildingHub TIL 2 181 ScorePlayer TIL 3 182 Unreal Engine MCP TIL 2 183 궁 미로 PalaceMaze TIL 1 184 메트로놈 Simple Metronome TIL 10 185 메트로놈 Simple Metronome TIL 11 186 오픈데이 Openday TIL 6 187 BuildingHub TIL 3 188 Obsidian vault에서 코드만 빼기 — directory junction 189 ScorePlayer TIL 4 190 여둘까 Office Layout TIL 11 191 오픈데이 Openday TIL 7 192 URL은 바뀔 수 있는 것에 묶지 않는다 193 도구는 기능이 아니라 내 일에 맞는지로 고른다 194 돌이키기 힘든 변경은 작게 먼저 확인한다 195 궁 미로 PalaceMaze TIL 2 196 궁 미로 PalaceMaze TIL 3 197 소리꽃 KeyBloom TIL 29 198 오픈데이 Openday TIL 8 199 BuildingHub TIL 4 200 ScorePlayer TIL 5 201 로그스톤 샵 LogStone Shop TIL 8 202 여둘까 Office Layout TIL 12 203 오픈데이 Openday TIL 9 204 BuildingHub TIL 5 205 MiniMacro TIL 3 206 소리꽃 KeyBloom TIL 30 207 오픈데이 Openday TIL 10 208 여둘까 Office Layout TIL 13 209 소리꽃 KeyBloom TIL 31 210 궁 미로 PalaceMaze TIL 4 211 로그스톤 샵 LogStone Shop TIL 9 212 로그스톤 샵 LogStone Shop TIL 10 213 소리꽃 KeyBloom TIL 32