오류 이해 및 처리

오류를 효과적으로 처리하려면 발생할 수 있는 오류 유형을 이해하는 것이 중요합니다. 발생할 수 있는 오류를 분류하는 것부터 시작해 보겠습니다.

웹 클라이언트 환경의 오류 유형

네트워크 오류

• 연결 문제: 서버 연결 설정에 문제가 있습니다.
• 시간 초과: 요청이 응답을 받는 데 너무 오래 걸립니다.
• DNS 오류: 도메인 이름 확인 관련 문제가 있습니다.
• HTTP 오류: 404 찾을 수 없음, 500 내부 서버 오류 등의 오류

서버 API 오류

• 잘못된 응답: 서버의 예상치 못한 데이터 또는 잘못된 형식의 데이터입니다.
• 인증 오류: 사용자 인증 또는 승인 관련 문제입니다.
• 비율 제한: API 사용 제한 초과로 인한 제한입니다.

사용자 브라우저 환경 오류

• 브라우저 호환성: 브라우저가 특정 기능을 처리하는 방식의 차이로 인해 발생하는 문제입니다.
• JavaScript 오류: 클라이언트측 JavaScript 코드에 오류가 있습니다.
• 리소스 로드 오류: 이미지, 스크립트, 스타일시트와 같은 리소스를 로드하는 데 문제가 있습니다.

기타 오류

• 클라이언트 측 오류: 사용자의 장치 또는 운영 체제와 관련된 오류입니다.
• UI/UX 오류: 끊어진 링크나 잘못된 레이아웃 등 사용자 인터페이스 또는 사용자 경험 관련 문제입니다.

다양한 유형의 오류가 발생할 수 있습니다. 그러나 이러한 오류는 일반적으로 다음 두 가지 범주로 분류될 수 있습니다.

1. 예상 오류: 발생 내용과 성격이 미리 알려진 오류입니다.
2. 예기치 못한 오류: 발생 여부와 성격을 미리 알 수 없는 오류입니다.

우리가 논의한 오류를 이러한 분류로 분류해 보겠습니다.

오류를 예상할 수 있습니까?

예상되는 오류

상태 코드가 명확한 서버 API에서 수신된 오류는 사전에 예측하고 해결할 수 있으므로 예상 오류로 간주될 수 있습니다.

예를 들어, 무단 접속(401), 접속 금지(403) 등의 오류는 상황에 따라 적절하게 처리할 수 있습니다. 또한, 오류에 대응하는 애플리케이션 로직을 관리하기 위해 각 상태 코드에 대해 보다 자세한 오류 코드를 정의하는 것이 일반적입니다. 이를 예상 오류라고 합니다.

예상치 못한 오류

반면 500 범위의 서버 오류는 예측할 수 없기 때문에 예기치 않은 오류로 분류됩니다. 어떤 이유로든 서버가 응답할 수 없는 상황은 언제든지 발생할 수 있습니다. 또한, 이용자의 네트워크 환경이나 브라우저 환경으로 인해 발생할 수 있는 오류는 예측하기 어렵기 때문에 예상치 못한 오류로 분류됩니다.

사용자 및 오류

오류는 환경뿐만 아니라 사용자와의 상호 작용을 기준으로 분류될 수도 있습니다. 오류를 분류하는 한 가지 방법은 사용자가 오류에 대해 조치를 취할 수 있는지 여부를 고려하는 것입니다. 이 분류 기준은 다음과 같습니다.

1. 사용자가 이해하고 해결할 수 있는 오류(사용자가 애플리케이션을 계속 사용하는 데 도움이 되는 오류)
2. 사용자가 해결할 수 없는 오류(사용자에게 도움을 제공하지 않는 오류).

해결 가능한 오류

예를 들어 인증 또는 승인 오류가 이 범주에 속합니다. 로그인하지 않은 사용자에게는 401 상태 오류가 발생할 수 있습니다. 이 경우 로그인 화면을 제공하거나 로그인이 필요하다는 메시지를 표시할 수 있습니다.

특정 화면에 대한 접근 권한이 없는 사용자의 경우, 관리자에게 접근 권한을 요청하도록 안내할 수 있습니다.

어떤 제품 개발자도 사용자 이탈을 환영하지 않습니다. 오류가 발생한 사용자에게 상황을 극복할 수 있는 지침을 제공하는 것이 필수적입니다. 예를 들어 일시적인 네트워크 오류에 대한 새로 고침 버튼을 제공하거나 존재하지 않는 페이지에 액세스할 때 이전 화면으로 돌아갈 수 있는 버튼을 제공합니다.

해결할 수 없는 오류

그러나 오류 상황을 사용자에게 알려주는 것이 전혀 도움이 되지 않는 경우가 있습니다. 예를 들어, 코드에 저사양 장치나 브라우저에서 작동하지 않는 구성 요소가 포함되어 있는 경우 사용자는 이에 대해 아무 조치도 취할 수 없습니다. (아마도 다른 브라우저를 사용하라고 제안하는 메시지일까요?)

1번과 2번의 두 사례 모두 메시지 제공과 관련됩니다. 차이점은 사례 1에는 사용자에게 조치를 취하도록 유도하는 일부 작업이나 지침이 포함되어 있다는 것입니다.

발생한 오류는 사용자가 스스로 해결할 수 있는 문제입니까, 아니면 해결할 수 없습니까?

오류 처리 방법

그렇다면 발생하는 오류는 어떻게 처리해야 할까요? 오류가 발생했을 때 애플리케이션은 사용자에게 어떤 종류의 인터페이스를 제공해야 합니까? 오류의 특성에 따라 다양한 유형의 오류를 해결하는 방법을 살펴보겠습니다.

예측할 수 없지만 해결 가능한 오류

일반적인 예는 네트워크 오류입니다. 이러한 현상은 사용자의 네트워크 환경에 따라 언제든지 발생할 수 있습니다. 가장 간단한 해결책은 사용자에게 '일시적인 오류'임을 알리고 이전 작업을 다시 시도하도록 안내하는 것입니다.

오차 범위

이러한 오류의 경우 애플리케이션 전체가 부정적인 영향을 받지 않는지 확인하는 것이 중요합니다. 예를 들어, 애플리케이션이 한 화면에서 10개의 API를 호출하는 경우 하나가 실패하더라도 전체 애플리케이션에서 오류 메시지가 트리거되어서는 안 되며 모든 호출을 다시 시도해야 합니다.

대신 실패한 부분만 복구하는데 집중하세요.

예측할 수 없고 해결할 수 없는 오류

예상하기 어렵고 직접적인 해결 방법이 없는 오류입니다. 개발 중에는 이러한 오류를 최소화해야 하며, 오류가 발생하면 처리할 수 있는 계획이 있어야 합니다. 사용자가 이러한 오류를 스스로 해결할 수 없으므로 고객 지원에 문의할 수 있는 쉬운 방법을 제공하는 것이 필요할 수 있습니다.

모니터링

개발자의 통제 범위를 벗어난 오류는 Sentry와 같은 도구를 사용하여 모니터링해야 합니다. 사용자에게 이러한 오류가 발생하지 않도록 하려면 이러한 오류를 수정해야 합니다. 또한 이러한 오류가 발생할 경우 사용자가 애플리케이션으로 돌아갈 수 있는 메커니즘이 있는지 확인하세요.

예측 가능하지만 해결 불가능한 오류

이러한 오류는 사용자가 해결할 수 없는 알려진 오류입니다. 사용자가 스스로 문제를 해결할 수 없다면 오류 처리 기회를 놓친 것입니다. 사용자가 의도적으로 비정상적인 동작을 수행하는 경우 보안 취약점이 있다는 신호일 수 있습니다.

보안 관련 오류

이러한 오류는 애플리케이션을 악용하려는 악의적인 의도가 있을 때 발생합니다. 이는 일반적으로 보안 취약성에서 발생하므로 개발 중에 예방해야 합니다. CORS 및 XSS와 같은 기본적인 보안 문제를 해결하고 보안 팀과 협력하여 안전한 애플리케이션을 구축하는 것이 중요합니다.

예측 가능하고 해결 가능한 오류

이러한 오류는 일반적으로 개발자가 이미 알고 있는 비즈니스 논리의 일부입니다.

• 401 무단 오류: 로그인이 필요합니다.
• 404 찾을 수 없음 오류: 잘못된 페이지에 액세스하고 있습니다.
• 기타 비즈니스 로직 오류: 애플리케이션의 로직에 의해 정의됩니다.

이러한 경우 애플리케이션 내에서 적절한 지침을 제공하거나 사용자에게 안내할 별도의 페이지를 만드세요.

지침의 중요성

사용자는 오류 메시지가 표시된 후 다음에 수행할 작업을 명확하게 이해해야 합니다. 이렇게 하면 오류 빈도를 줄이고 사용자 이탈을 방지할 수 있습니다. 따라서 오류 메시지와 함께 클릭 유도 문구를 포함하는 것이 필수적입니다.

예를 들어 필드 유효성 검사 오류가 있는 경우 오류가 발생한 필드에 집중하세요. 사용자가 존재하지 않는 페이지로 이동한 경우 이전 화면으로 돌아갈 수 있는 버튼을 제공합니다.

결론

오류 처리를 살펴보았습니다. 제한된 범위 내에서 오류를 잡아낼 수 있는 오류 모니터링 도구와 React의 ErrorBoundary 등 다양한 도구와 기술을 활용하여 효율적으로 오류를 관리해보자.