오류 콘솔에서 오류 보기

오류 콘솔 가시성

오류 콘솔은 첫 번째 오류가 발생한 후에만 표시됩니다. 오류 콘솔에 현재 로그인한 사용자에 대한 오류만 표시됩니다. 관리자는 오류 콘솔에서 다른 사용자가 발생한 오류를 볼 수 없습니다. 사용자가 닫으면 다음 오류가 발생할 때까지 닫히지 않습니다.

오류 콘솔은 Lightning Experience 모든 사용자에게 표시되며 디버그 모드가 설정되면 동작이 다릅니다.

디버그 모드가 비활성화되면 치명적인 오류만 오류 대화 상자를 트리거하여 해제해야 합니다. 경고(경고) 및 자동(자시) 오류는 오류 콘솔에 기록됩니다.

디버그 모드가 활성화되면 치명적인 오류 및 경고로 인해 해제해야 하는 오류 대화 상자가 트리거됩니다. 자동 오류는 자동 오류 표시를 선택하지 않는 한 콘솔에서 숨겨집니다.

필터 오류

콘솔에서 오류를 필터링하려면 드롭다운 메뉴에서 다음 옵션 중 하나를 선택합니다.

• 모든 오류: 고객 오류와 시스템 오류 모두 표시
• 고객 오류: 고유한 네임스페이스와 연결된 고객 구성 요소의 오류가 표시됩니다.
• 시스템 오류: force 또는 Lightning과 같은 네임스페이스에서 Salesforce에서 작성한 구성 요소인 시스템 구성 요소의 오류를 표시합니다.

오류는 가장 최근 오류를 먼저 사용하여 타임스탬프별로 정렬됩니다. 기본적으로 자동 오류는 콘솔에서 필터링됩니다. 비활성 오류 표시를 선택하지 않으면 치명적인 오류 및 경고만 표시됩니다.

음소거 오류를 활성화하려면 음소거 오류 표시 확인란을 선택합니다. 자동 오류는 페이지와의 상호 작용에 영향을 미치지 않으며 Salesforce에서 진단을 위해 자동으로 기록됩니다.

오류 유형

고객 오류와 시스템 오류는 심각도 수준이 다를 수 있습니다.

• 사고 오류: 빨간색 오류 아이콘으로 표시되는 치명적인 오류는 중요하며 기능을 중단할 수 있습니다.
• 경고 오류(경고): 노란색 경고 아이콘으로 표시된 경고는 사용자가 주의를 기울여야 하는 복구 가능한 오류입니다.
• 소거 오류: 회색 정보 아이콘으로 표시되는 자동 오류는 내부 논리 또는 백그라운드 실패에 사용되는 중요하지 않은 진단 또는 텔레메트리 오류입니다. 자동 오류는 낮은 수준의 예외 및 백그라운드 오류를 제거하여 오류 대화 상자를 방지합니다.

치명적 오류

다음은 치명적인 고객 오류를 트리거하는 몇 가지 예시 시나리오입니다.

• 사용자 정의 컨트롤러의 Apex 예외: 사용자 정의 Apex 컨트롤러가 처리되지 않은 예외를 표시하거나 사용자 정의 LWC 구성 요소가 예외를 반환하는 Apex 메서드를 호출합니다.
• 사용자 정의 구성 요소의 JavaScript 런타임 오류: 고객의 LWC JavaScript 코드에서 유형 오류 또는 고객의 Aura 구성 요소 컨트롤러에서 null 참조
• 앱 초기화 실패: 레코드 레이아웃 실패와 같은 문제로 인해 Salesforce가 로드할 수 없음

치명적인 시스템 오류는 다음과 같습니다.

• Salesforce 플랫폼 내부 오류: Lightning 프레임워크 로드 실패 또는 Aura 엔진 초기화 실패
• 누락된 구성 요소 정의: 필수 Salesforce 시스템 구성 요소 누락 또는 구성 요소 채우기에 실패

알림

다음은 고객 오류에 대한 경고를 트리거하는 몇 가지 예시 시나리오입니다.

• AuraHandledException을 유발하는 서버 작업 오류: 사용자 정의 Apex AuraHandledException을 실행합니다.
• 확인 오류: Apex 유효성 검사는 친근한 메시지와 함께 실패합니다 - GenericEventException: 서버 이벤트 처리 오류
• 기본 서버 오류 처리: 사용자 정의 @AuraEnabled 메서드는 오류 또는 사용자 정의 구성 요소의 서버측 검증 실패를 반환합니다.

시스템 오류 경고에는 다음이 포함됩니다.

• XHR 생성 실패: 서버 통신 또는 JWT 토큰 설정 실패를 위해 XMLHttpRequest를 만들 수 없음
• 네트워크 또는 통신 오류: 서버 시간 초과 또는 Salesforce 연결 문제
• 사용할 수 없는 구성 요소: 요청된 시스템 구성 요소가 아직 로드되지 않았거나 원격 종속성 가져오기에 실패했습니다.

무시 오류

다음은 자동 고객 오류를 트리거하는 몇 가지 예시 시나리오입니다.

• 수명 주기 및 초기화 실패 처리: 초기화 구문을 렌더링하는 동안 또는 초기화 후에 오류가 발생합니다.
• 설명자 정규화: 잘못된 문자열 또는 구성 개체로 인해 정의 설명자가 정규화에 실패했습니다.

다음은 자동 시스템 오류를 트리거하는 몇 가지 예제 시나리오입니다.

• 수분 오류: 클라이언트측 JavaScript를 서버 렌더링 HTML에 연결하고 내보내기 코드 실행에 실패하면 잘못된 채우기 프로세스가 발생합니다.
• 내부 XHR 규칙 적용: 대기열에 이미 있는 작업을 추가하려고 시도하거나 XHR 수가 필수 최소값 미만임
• 위치 변경 이벤트 누락: 위치 변경 이벤트에 대해 앱에 지정된 이벤트가 누락되었습니다.

사용량 고려 사항

오류 콘솔을 사용할 때 다음 지침 및 제한 사항에 유의하십시오.

• 자동 오류는 오류 콘솔을 열지 않지만 콘솔이 이미 열려 있는 경우 목록을 새로 고칩니다.
• 오류 콘솔은 Aura 및 LWC 오류만 기록합니다. Visualforce 또는 Flow의 오류는 오류 콘솔에 기록되지 않습니다.