개발 취재 노트

크롬은 되는데 웨일 브라우저에서만 스크립트가 안 돌 때 — Cannot destructure property of undefined

안드로이드 웨일에서만 영상 선택 뒤 버튼이 켜지지 않던 문제는 fingerprint.js를 mediacheck.js로 바꾸고 두 페이지의 참조를 수정한 뒤 해결됐다. 추적 방지가 파일명을 차단했다는 설명은 가설이며, 차단 규칙 자체를 확인한 기록은 없다.

각자 폰에 준비한 안무 영상을 리더의 조작에 맞춰 재생하는 무용 연습용 영상 동기화 웹앱을 만들고 있었다. 노트북에 서버를 매번 띄우는 번거로움을 줄이려고 동기화 신호를 클라우드로 옮긴 뒤, 안드로이드 웨일에서 영상을 골라도 방 만들기와 참여 버튼이 켜지지 않았다. 같은 폰의 일반 크롬에서는 동작했다.

결론

이번 웨일(안드로이드) 장애는 fingerprint.js를 mediacheck.js로 바꾸고 두 페이지의 참조를 수정한 뒤 해결됐다. 배포 후 정상 동작했다는 응답이 있었다.

원인은 일부만 확정이다. 확정된 것과 아직 모르는 것을 나란히 적는다.

확정 (기록으로 확인됨)미확정 (기록 없음)
페이지 진입 직후 window.FormationFingerprint가 undefined여서 fingerprintVideo 구조분해가 중단됐다 왜 그 객체가 만들어지지 않았나
이 초기화 실패 때문에 뒤의 파일 이벤트 처리와 WebSocket 연결 코드가 실행되지 않았다는 것이 당시 분석이었다 스크립트가 다운로드에서 막혔나, 받았지만 실행에 실패했나
파일명을 바꾼 뒤 웨일에서 정상 동작했고, 데스크톱에서는 객체와 함수가 확인됐다 웨일의 추적 방지가 fingerprint.js라는 이름을 차단했다는 설명은 당시 분석의 유력 가설일 뿐, 차단한 기능·규칙은 특정되지 않았다

즉 독자가 얻을 수 있는 것은 "이름을 바꾸면 이번엔 풀렸다"는 처방이지, 웨일의 차단 원리에 대한 답이 아니다. 같은 증상이라고 모든 환경에 이 처방이 통한다는 뜻도 아니다.

아래는 수정 방향을 보여주는 예시다. 기록에 태그 변경 내역 전체가 남아 있지 않아 실제 코드를 그대로 옮긴 것은 아니다.

<!-- 변경 전 -->
<script src="fingerprint.js"></script>
<!-- 변경 후 -->
<script src="mediacheck.js"></script>

이번 기록에서 따라갈 진단 순서.

  1. 파일 선택 뒤 처리만 보지 말고 페이지 진입 직후 오류부터 확인한다. 이번에는 ?debug=1 화면 패널에 파일을 고르기 전부터 구조분해 오류가 표시됐다.
  2. 오류가 가리키는 객체와 그것을 준비하는 스크립트를 확인한다. 이 사건에서는 window.FormationFingerprint가 없었다.
  3. 파일명 차단 가설을 시험하기 위해 스크립트를 mediacheck.js로 바꾸고 두 페이지의 참조를 수정했다. 배포 후 정상 동작 응답을 받았다.

함께 복원한 파일 선택 필터(확장자 지정)가 웨일 실기기에서 원하는 선택 화면을 띄우는지는 확인 기록이 없다.

상황

리더가 연습방을 만들고 영상을 선택하면, 참여자는 방 목록에서 자기 방에 들어가 각자 준비한 영상 파일을 고르는 흐름이다. 영상은 별도로 공유하고, 앱은 리더 조작에 맞춰 재생하도록 동기화 신호를 전달하는 구조로 설계했다.

서로 같은 영상을 골랐는지 확인하기 위해 파일 일부로 계산한 식별값인 ‘영상 지문’을 대조한다. 이를 계산하는 공통 스크립트가 fingerprint.js였고, 페이지는 이 스크립트가 준비하는 window.FormationFingerprint 객체의 함수를 사용했다. 영상 선택 뒤 버튼이 켜지지 않는 문제를 쫓다가, 그보다 앞선 공통 스크립트 초기화 실패를 발견한 사건이다.

증상

안드로이드에서 영상 파일명은 보였지만 방 만들기와 참여 버튼이 활성화되지 않았다. 뷰어는 방 정보를 불러오는 상태에 머물렀고, 아이폰과 데스크톱은 됐다. 이후 같은 안드로이드 폰에서도 일반 크롬은 되고 웨일은 안 된다는 비교가 나왔다.

8월 25일의 첫 제보 이후 8월 30일에도 진행할 수 없다는 보고가 이어졌다. 화면 디버그 패널을 붙인 뒤 받은 로그의 핵심은 다음과 같다. 환경은 Android 10의 Whale 3.9.14.9(Chrome 138 기반)였다. 오류 뒤에 붙어 있던 배포 주소는 생략했다.

secureContext: true | crypto.subtle: true | Blob.arrayBuffer: true | File.text: true
❌ window.error: Uncaught TypeError: Cannot destructure property 'fingerprintVideo' of 'window.FormationFingerprint' as it is undefined.

원인

로그가 확인해 주는 것은 나열한 API의 지원 여부와 구조분해 시점의 객체 부재다. 지원 표시만으로 암호화나 파일 읽기 호출까지 정상이라고 판정할 수는 없다. 또한 객체가 없다는 사실만으로 다운로드 차단과 실행 실패를 구별할 수도 없다.

당시에는 .html 없는 /leader에서 상대경로가 잘못됐을 가능성도 의심했다. 하지만 데스크톱에서 같은 경로로 열었을 때 객체가 정상이라는 확인이 나와, 그 경로만으로 웨일의 실패를 설명하기는 어려워졌다. 이후 파일명 차단 가설에 따라 이름을 바꿨고 정상 동작 확인을 받았다. 차단 기능 자체를 특정한 실험 결과는 남아 있지 않다.

해결

fingerprint.js를 mediacheck.js로 바꾸고 두 페이지의 참조를 수정해 배포했다. 파일 헤더 주석에도 이름을 바꾼 이유를 기록했다. 데스크톱에서는 새 파일 로드와 기존 FormationFingerprint 객체, 함수 존재를 확인했다.

이어 “된다!! 됐어! 잘했다!”라는 응답과 파일 선택 필터를 다시 넣어 달라는 요청이 왔다. 마지막에는 확장자 필터 복원과 배포가 보고됐지만, 복원한 필터가 웨일에서 원하는 화면을 띄우는지에 대한 후속 확인은 없다. 이때 에이전트는 앞서 확장자 필터가 "안 됐던" 것도 스크립트 차단 탓이었다고 다시 해석했는데, 필터 시도마다 그 원인을 따로 검증한 기록은 없는 해석이다. 파일명 변경의 성공과 필터 복원의 검증 상태는 별개다.

재발 방지 설계에서는 필수 객체가 없을 때 명확한 오류를 표시하고, 그 객체에 의존하는 버튼과 처리를 중단하는 편이 낫다. 단순히 함수를 null로 두고 초기화를 계속하는 예제는 이후 호출부까지 보호하지 못하므로 여기서는 제시하지 않는다. 이는 이번에 적용한 내역이 아니라 추가 설계 제안이다.

취재 후기 — 파일을 고르기 전에 이미 멈춰 있었다

기록에 남은 가설과 관찰을 네 사람이 직접 디버깅하는 장면으로 재구성했다.

박도은
각자 폰에 둔 안무 영상을 리더 조작에 맞춰 보는 웹앱 있잖아. 내 안드로이드에서는 영상 파일명은 보이는데 방 만들기와 참여 버튼이 안 켜져.
정바다
파일명은 보인다면 그다음 영상 길이를 읽는 readDuration이 기다리는 걸 거야. 길이 같은 기본 정보가 준비됐다는 loadedmetadata 신호를 못 받으면 멈추거든.
정하늘
그 기다림이 문제라면 시간 제한을 두면 달라지겠지. 길이를 못 읽어도 진행하게 수정했으니, 같은 기기에서 다시 확인해 보자.
박도은
다시 해도 참여 버튼이 안 켜져. 아이폰과 데스크톱은 되는데 내 폰은 방 정보를 불러오는 중이라는 문구에 머물러.
정바다
그럼 길이 읽기만 고쳐서는 해결이 안 된 거네. 방 정보가 안 온다니 서버와 연결을 유지하며 정보를 주고받는 WebSocket 쪽이 의심돼.
박도현
방 정보가 안 온다는 것과 연결 자체가 원인이라는 건 다르잖아. 실제 연결 상태는 확인했어?
정하늘
데스크톱 참여자 화면에서는 연결됐고 방 정보도 받았어. 폰에도 연결 상태를 표시했으니, 브라우저를 바꿔서 차이가 있는지 보자.
박도은
바꿔 보니 일반 크롬은 잘 돼. 지금 실패하는 건 내가 쓰는 웨일이야.
정바다
웨일에서만 그러면 광고나 추적을 막는 기능이 통신을 차단하는 걸까? 그 설정을 바꿔서 비교하면 어떨까?
박도은
그 비교 전에 파일 선택 화면도 봐줘. 구글 포토가 열리는 것 같아서 기본 설정을 지웠는데도 클라우드 미디어에 접근한다는 안내가 나와.
정바다
그 안내라면 파일 형식을 제한하는 accept 값 때문 아닐까? 모든 영상 형식을 뜻하는 video/*를 빼고 구체적인 형식으로 바꿔 보자.
박도은
그렇게 바꿔도 마찬가지야. 동선 파일은 선택이 괜찮은데, 영상도 .json처럼 확장자만 지정하면 어떨까?
정하늘
그 비교를 해보자. 영상 입력에 확장자만 남겼어. 파일 선택 화면이 달라지는지 확인해 줘.
박도은
확장자만 남겨도 안 됐어. 이후 필터를 아예 뺀 버전으로 닷새 뒤 다시 해 봤는데도 파일 선택 뒤 재생할 상태로 넘어가지 못해.
박도현
그럼 필터를 바꾼 걸로 해결됐다고 할 수는 없네. 파일을 고르는 화면과 고른 뒤 처리가 멈추는 문제를 나눠 보자. 어디서 멈추는지 오류부터 볼 수 없어?
정하늘
볼 수 있게 화면 디버그 패널을 붙였어. ?debug=1로 열면 파일 선택부터 길이 읽기, 같은 영상인지 비교할 식별값인 지문 계산까지 확인할 수 있어.
박도은
그 패널에 파일을 고르기도 전에 오류가 떠. window.FormationFingerprint가 undefined라는데, 이건 뭘 못 찾았다는 거야?
정하늘
영상 지문 계산 함수 fingerprintVideo를 담아야 할 공용 객체가 없다는 뜻이야. 그 객체에서 함수를 꺼내는 구조분해 단계에서 멈췄어.
정바다
그 객체가 없다면 주소가 .html 없는 /leader인 게 문제 아닐까? 상대경로로 스크립트를 찾다가 위치가 꼬였을 수도 있잖아.
정하늘
그 주소로 데스크톱에서 열어도 객체는 정상이야. 경로만으로 차이를 설명하기는 어려워. 대신 fingerprint.js라는 파일명이 차단되는 건 아닌지 시험해 보자.
정바다
같은 경로에서 객체가 있다면 주소 탓이라고 단정한 건 성급했네. 파일명 가설은 어떤 이름으로 바꿔서 확인할 거야?
정하늘
mediacheck.js로 바꾸고 두 페이지의 참조도 수정해 배포했어. 데스크톱에서는 새 파일과 기존 객체, 함수까지 확인했으니 웨일에서 다시 열어 봐.
박도은
이름 바꾼 버전은 이제 돼! 그럼 영상 파일만 고를 수 있게 선택 필터도 다시 넣어줘.
박도현
동작한 건 좋네. 그런데 그 결과만으로 추적 방지가 파일명을 막았다고 확정할 수 있어?
정하늘
거기까지는 확인 못 했어. 이름을 바꾼 뒤 동작했다는 게 확인된 결과야. 요청한 확장자 필터도 복원해 배포했지만, 웨일에서 원하는 선택 화면이 뜨는지는 더 확인해야 해.
박도현
그럼 해결된 범위는 그렇게 적자. 여러 기능이 함께 멈추면 최초 오류부터 확인하고, 해결된 관찰과 원인에 대한 추론은 구분해야 해.