브라우저 개발자 도구 F12, 웹페이지 오류 1차 진단법
음식점에 주문을 넣었는데 20분이 지나도 음식이 나오지 않는다면 원인은 두 가지 중 하나입니다. 주방에서 재료를 구하지 못해 멈춰 있거나, 홀 직원이 주문서를 주방에 전달하지 못한 경우입니다.
웹페이지에서 버튼이 먹통이 되거나 하얀 빈 화면만 나올 때 주방과 홀 사이의 전달 내역을 펼쳐 보여 주는 영수증이 바로 브라우저 개발자 도구입니다. 다만 식당 영수증은 결과만 찍혀 나오지만, 키보드 F12를 눌러 여는 이 도구는 내 브라우저가 서버에 보낸 요청과 되돌아온 응답 코드, 그리고 화면 내부 자바스크립트 오류까지 실시간으로 기록해 줍니다.
비개발자도 꼭 볼 줄 알면 좋은 Console과 Network 두 탭
크롬이나 엣지에서 개발자 도구(DevTools, Developer Tools)를 처음 열면 수많은 영어 탭이 떠서 막막하기 쉽습니다. 하지만 일반 사용자가 브라우저 개발자 도구로 접속 오류의 원인을 1차 판별할 때는 딱 두 곳만 확인하면 충분합니다.
첫째는 Console(콘솔) 탭으로, 페이지 안의 스크립트가 실행되다 부딪힌 빨간색 에러 메시지를 보여 줍니다. 여기서 `ERR_BLOCKED_BY_CLIENT` 같은 문구가 보인다면 광고 차단 확장 프로그램이나 보안 프로그램이 해당 스크립트를 막고 있다는 직접적인 증거가 됩니다.
둘째는 Network(네트워크) 탭으로, 페이지에 필요한 HTML·이미지·데이터 요청이 서버와 정상적으로 주고받았는지 상태 숫자(200, 403, 404, 500 등)와 소요 시간을 표로 띄워 줍니다. 개발자 도구는 웹페이지 문제를 고치는 마법 버튼이 아니라 내 브라우저가 겪은 장애 기록을 그대로 비추는 블랙박스라는 점을 이해하면 불필요한 재설치를 줄일 수 있습니다.
브라우저 개발자 도구로 웹 오류 1차 진단하는 4단계
화면이 멈추거나 결제·제출 버튼이 반응을 보이지 않을 때, 아래 순서대로 확인하면 내가 고칠 수 있는 확장·캐시 문제인지 서버 장애인지 금방 가려낼 수 있습니다.
F12 개발자 도구 1차 진단 절차
- 도구 열기 및 탭 선택: 문제가 생긴 페이지에서 F12(또는 Ctrl + Shift + I)를 눌러 패널을 열고, 먼저 ‘Network’ 탭을 클릭합니다.
- 캐시 비우고 새로고침 테스트: Network 탭 상단의 ‘Disable cache(캐시 사용 중지)’에 체크한 상태에서 F5 또는 새로고침 버튼을 눌러 목록에 빨간 줄이 뜨는지 살핍니다. (빨간 줄의 Status 숫자가 500·502·504면 서버 측 장애입니다.)
- Console 탭 빨간 에러 확인: ‘Console’ 탭으로 넘어가 `ERR_BLOCKED_BY_CLIENT`가 보이면 설치된 광고 차단 확장이나 보안 모듈을 점검하고, `CORS`나 `TypeError`가 서버 API 호출에서 떴다면 사이트 운영자 측 코드 문제일 가능성이 높습니다.
- 고객센터 전달용 캡처 및 HAR 저장: 기업·학교 시스템 지원팀에 문의할 때 오류 화면만 찍지 말고 Console 빨간 줄 캡처나 Network 탭의 ‘Export HAR'(단, 비밀번호·개인정보 포함 가능성 있으므로 민감 페이지 제외) 기록을 함께 전달하면 훨씬 빨리 해결됩니다.
F12 주요 탭별 점검 포인트 요약
| 구분 | 살펴볼 핵심 표시 | 진단 결과 해석 |
|---|---|---|
| Network 탭 (Status 열) | 200 (정상) / 4xx / 5xx / (blocked:other) | 5xx는 서버 오류, blocked 표시는 내 PC 확장·보안 차단 |
| Console 탭 (빨간 X 줄) | ERR_BLOCKED_BY_CLIENT, NetworkError 등 | 광고 차단·확장 충돌 또는 스크립트 실행 실패 지점 확인 |
| Disable cache 체크 | 이전 캐시를 무시하고 서버에서 새 파일 수신 | 오래된 브라우저 캐시 때문에 화면이 깨진 것인지 즉시 검증 |
핵심 정리
주문 내역서를 들여다보듯 브라우저 개발자 도구의 Network 탭과 Console 탭만 확인해도 웹사이트 오류가 내 확장 프로그램 탓인지, 아니면 상대방 서버 응답 실패인지 정확히 가를 수 있습니다. 다음번에 웹페이지가 먹통이 되면 무작정 브라우저를 지우기 전에 F12를 눌러 빨간 줄의 상태 코드와 차단 메시지를 먼저 읽어 보시기 바랍니다.
재발 방지 체크리스트
재발 방지 체크리스트
- Network 탭에서 `blocked:client` 또는 `ERR_BLOCKED_BY_CLIENT`가 보이면 광고 차단 확장을 잠시 일시 중지하고 다시 시도합니다.
- 개발자 도구를 연 상태에서 새로고침 버튼을 마우스 오른쪽 클릭해 ‘캐시 비우기 및 강력 새로고침’을 활용할 수 있습니다.
- Network 진단 기록(HAR)을 외부에 공유할 때는 쿠키나 로그인 토큰이 포함될 수 있으므로 공개 게시판에 그대로 올리지 않습니다.
- 테스트를 마친 뒤에는 `Disable cache` 체크를 풀어 평소 웹서핑 속도가 느려지지 않게 원복합니다.









