웨일 브라우저에서 확장프로그램(애드온) 설치가 안 되는 문제는 웨일 스토어 자체 오류부터 크롬 웹스토어 확장 호환성 문제까지 원인이 다양합니다. 이 글에서는 웨일 브라우저 확장프로그램 설치 실패 10가지 상황을 원인별로 나눠 실제로 따라 할 수 있는 해결 순서까지 정리했습니다.
원인: 브라우저 캐시가 꼬여있거나, 웨일 버전이 오래되어 스토어와 통신이 원활하지 않은 경우입니다.
해결방법: 주소창에 whale://version을 입력해 현재 버전을 확인하고, whale://settings/help에서 최신 버전으로 업데이트합니다. 이후 whale://settings/clearBrowserData에서 캐시된 이미지 및 파일을 삭제한 뒤 재시도합니다.
증상
원인
해결경로
설치버튼 무반응
구버전·캐시 문제
whale://settings/help → 업데이트
업데이트 후에도 동일
캐시 손상
whale://settings/clearBrowserData
2. 크롬 웹스토어 확장프로그램이 설치되지 않는 경우
증상: 웨일 자체 스토어가 아닌 크롬 웹스토어에서 확장프로그램을 설치하려 하면 "Chrome에 추가" 버튼이 비활성화되어 있습니다.
원인: 웨일은 크롬 웹스토어 확장 설치를 지원하지만 설정에서 이 기능이 꺼져 있거나, 확장프로그램이 크롬 웹스토어 정책상 웨일 호환을 차단한 경우입니다.
해결방법: whale://extensions 페이지 우측 상단의 "다른 스토어의 확장 프로그램 허용" 옵션이 켜져 있는지 확인합니다. 꺼져 있다면 켠 뒤 크롬 웹스토어 페이지를 새로고침(F5)해 다시 설치를 시도합니다.
증상
원인
해결경로
크롬스토어 설치버튼 비활성
다른 스토어 허용 옵션 꺼짐
whale://extensions에서 옵션 활성화
활성화 후에도 실패
확장 자체 호환 차단
웨일 자체 스토어의 대체 확장 검색
3. 설치 중 "손상된 파일" 오류가 뜨는 경우
증상: 설치 진행 중 "패키지가 손상되어 설치할 수 없습니다" 메시지가 나타납니다.
원인: 다운로드 도중 네트워크가 끊겨 파일이 불완전하게 받아졌거나, 백신 프로그램이 설치 파일을 임의로 수정·차단한 경우입니다.
해결방법: whale://downloads에서 실패한 설치 파일을 삭제하고, 사용 중인 백신(알약·V3 등)의 실시간 검사 예외 목록에 웨일 브라우저 설치 경로를 추가한 뒤 안정적인 네트워크 환경에서 재다운로드합니다.
증상
원인
해결경로
손상된 파일 오류
다운로드 중단
whale://downloads에서 삭제 후 재다운로드
반복 손상
백신 프로그램 간섭
백신 예외처리 후 재시도
4. 설치는 됐는데 아이콘이 안 보이는 경우
증상: 설치 완료 메시지는 떴는데 툴바에 확장프로그램 아이콘이 표시되지 않습니다.
원인: 웨일의 확장프로그램 표시 설정에서 해당 확장이 숨김 처리되어 있는 경우입니다.
해결방법: 주소창 오른쪽의 퍼즐 모양 아이콘(확장 프로그램 관리)을 클릭한 뒤, 목록에서 해당 확장 옆 핀 아이콘을 눌러 툴바에 고정합니다. 목록에도 안 보이면 whale://extensions에서 사용 설정이 켜져 있는지 다시 확인합니다.
증상
원인
해결경로
툴바에 아이콘 없음
숨김 처리됨
퍼즐 아이콘→핀 고정
목록에도 없음
사용 설정 꺼짐
whale://extensions에서 사용 활성화
5. 회사·기관 PC에서 정책상 설치가 막힌 경우
증상: 개인 PC에서는 잘 되는데 회사나 학교 PC에서는 설치 자체가 차단됩니다.
원인: 그룹정책이나 관리자 설정으로 확장프로그램 설치가 원천 차단되어 있는 경우입니다.
해결방법: whale://policy 페이지를 열어 ExtensionInstallBlocklist 등 관련 정책이 적용되어 있는지 확인합니다. 정책이 적용된 관리 환경이라면 개인 권한으로는 해제가 불가능하므로 IT 담당자에게 설치 허용을 요청해야 합니다.
증상
원인
해결경로
기관 PC 설치 차단
그룹정책 제한
whale://policy로 정책 확인
개인 해제 불가
관리자 권한 필요
IT담당자에게 허용 요청
6. 확장프로그램 업데이트 후 갑자기 비활성화되는 경우
증상: 잘 쓰던 확장프로그램이 자동 업데이트된 후 회색으로 바뀌며 꺼진 상태가 됩니다.
원인: 업데이트된 버전이 요구하는 권한이 늘어나 웨일이 자동으로 재승인을 요구하며 임시 비활성화하는 경우입니다.
해결방법: whale://extensions에서 해당 확장의 "세부정보"를 클릭해 요구 권한 목록을 확인하고, 사용 설정 토글을 다시 켜서 권한 재동의 팝업이 뜨면 승인합니다.
증상
원인
해결경로
업데이트 후 비활성화
권한 변경 재승인 필요
세부정보→사용설정 토글 재승인
승인해도 재차 꺼짐
확장 자체 오류
확장 삭제 후 이전 버전 재설치
7. 웨일 스토어 자체가 로딩되지 않는 경우
증상: 웨일 스토어 페이지 접속 시 흰 화면만 뜨고 목록이 아예 로딩되지 않습니다.
원인: DNS 문제이거나 웨일 스토어 서버 자체의 일시적 장애인 경우입니다.
해결방법: 설정 → 개인정보 및 보안에서 DNS를 8.8.8.8(Google) 또는 1.1.1.1(Cloudflare)로 변경해보고, 시크릿 모드(Ctrl+Shift+N)로 접속해 확장프로그램이나 캐시 영향인지 구분합니다.
증상
원인
해결경로
스토어 흰화면
DNS·서버 문제
DNS 8.8.8.8로 변경 후 재접속
시크릿모드는 정상
확장·캐시 충돌
문제 확장 비활성화 후 재시도
8. 개발자 모드 확장프로그램이 자동 삭제되는 경우
증상: 개발자 모드로 압축 해제된 확장프로그램을 로드했는데 브라우저를 재시작하면 사라져 있습니다.
원인: 웨일이 스토어 미등록 확장을 보안상 매 세션마다 재검증하며, 원본 폴더가 이동되거나 삭제된 경우 함께 사라지는 것입니다.
해결방법: whale://extensions에서 개발자 모드를 켠 상태를 유지하고, 압축해제된 확장 프로그램 폴더를 삭제·이동되지 않는 고정 경로(예: C:\dev-extensions)에 보관한 뒤 "압축해제된 확장 프로그램을 로드합니다"로 다시 불러옵니다.
증상
원인
해결경로
재시작 후 사라짐
원본 폴더 이동·삭제
고정 경로에 폴더 보관 후 재로드
개발자모드 꺼짐
보안 재검증
whale://extensions에서 개발자모드 재활성화
9. 특정 확장프로그램만 설치가 반복 실패하는 경우
증상: 다른 확장은 다 설치되는데 유독 하나만 계속 "설치 실패" 메시지가 뜹니다.
원인: 해당 확장프로그램의 manifest 버전이 웨일이 지원하지 않는 구버전이거나, 최신 Manifest V3 정책에 맞지 않는 경우입니다.
해결방법: 해당 확장프로그램 개발자 페이지나 리뷰에서 다른 사용자도 같은 오류를 겪고 있는지 확인하고, 비슷한 기능의 대체 확장프로그램을 웨일 스토어에서 검색해 사용하는 것이 가장 현실적인 해결책입니다.
증상
원인
해결경로
특정 확장만 실패
구버전 manifest 비호환
대체 확장프로그램 검색·사용
개발자 확인 필요
확장 자체 결함
리뷰·문의로 이슈 확인
10. 설치 후 웨일 브라우저가 느려지거나 멈추는 경우
증상: 확장프로그램을 여러 개 설치한 뒤부터 웨일 브라우저 전체가 눈에 띄게 느려집니다.
원인: 여러 확장프로그램이 동시에 백그라운드에서 리소스를 점유하며 메모리·CPU 부담이 커진 경우입니다.
해결방법: Shift+Esc로 웨일 작업관리자를 열어 확장프로그램별 메모리·CPU 사용량을 확인하고, 사용 빈도가 낮은 확장은 whale://extensions에서 삭제하거나 필요할 때만 켜서 사용하도록 정리합니다.
증상
원인
해결경로
설치 후 전반적 저하
다수 확장 리소스 점유
Shift+Esc 작업관리자로 사용량 확인
특정 확장 원인 확인
고부하 확장 존재
불필요 확장 삭제·비활성화
자주 묻는 질문 (FAQ)
Q1. 웨일 스토어에서 설치 버튼이 눌리지 않아요.
whale://settings/help에서 웨일을 최신 버전으로 업데이트하고, whale://settings/clearBrowserData에서 캐시를 삭제한 뒤 다시 시도해보세요.
Q2. 크롬 웹스토어 확장은 웨일에서 못 쓰나요?
쓸 수 있습니다. whale://extensions 페이지에서 "다른 스토어의 확장 프로그램 허용" 옵션을 켠 뒤 크롬 웹스토어 페이지를 새로고침해서 설치해보세요.
Q3. 회사 컴퓨터에서 확장프로그램 설치가 안 돼요.
whale://policy에서 확장 설치를 막는 그룹정책이 적용되어 있는지 확인해보세요. 관리 환경이라면 개인이 직접 해제할 수 없어 IT 담당자에게 요청해야 합니다.
Q4. 확장프로그램을 설치한 후 브라우저가 느려졌어요.
Shift+Esc로 웨일 작업관리자를 열어 어떤 확장이 리소스를 많이 쓰는지 확인하고, 자주 안 쓰는 확장은 삭제하거나 필요할 때만 켜서 사용하는 것이 좋습니다.
