오류 처리
📋 문서 버전
이 문서는 3개의 버전이 있습니다. 현재 최신 버전을 보고 있습니다.
오류 처리
JavaScript는 동적 언어의 특성상 런타임 오류가 발생할 가능성이 높으며, 효과적인 오류 처리는 안정적인 애플리케이션 개발에 필수적입니다. 이 문서는 JavaScript에서의 오류 처리 기법, 내장 오류 유형, 디버깅 방법론, 모범 사례를 체계적으로 정리합니다.
1. JavaScript의 주요 오류 유형
JavaScript 엔진은 다양한 표준 오류 타입을 제공합니다. 각 오류는 Error 객체를 상속받으며, 오류 원인을 구체적으로 식별할 수 있습니다.
| 오류 유형 | 설명 | 발생 시나리오 예시 |
|---|---|---|
| SyntaxError | 코드 구문 오류 | let x = 5 +; |
| TypeError | 잘못된 데이터 타입 사용 | null.toUpperCase() |
| ReferenceError | 정의되지 않은 변수 참조 | console.log(undeclaredVariable) |
| RangeError | 범위를 벗어난 값 사용 | new Array(-1) |
| URIError | URI 관련 함수 사용 오류 | decodeURIComponent("%") |
| EvalError | eval() 함수 관련 오류 (현대 브라우저에서는 사용되지 않음) |
eval("return 1") 내부 사용 |
| AggregateError | 여러 오류를 포함하는 컨테이너 | <a href="/doc/%EA%B8%B0%EC%88%A0/%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D/JavaScript/Promise" class="wiki-link wiki-link-missing">Promise</a>.any() 실패 시 |
2. 오류 처리 메커니즘
2.1 try...catch...finally 구문
try {
// 오류 발생 가능 코드
const result = riskyOperation();
console.log("결과:", result);
} catch (error) {
// 오류 처리
console.error("오류 발생:", error.message);
} finally {
// 항상 실행되는 정리 코드
console.log("작업 종료");
}
- try: 오류 검출 대상 코드 블록
- catch: 발생한 오류를 받아 처리
- finally: 성공/실패 여부와 무관하게 실행
⚠️ 주의사항:
catch블록에서 구체적인 오류 타입을 체크하는 것이 안전합니다.
> if (error instanceof TypeError) { > // 타입 에러 특화 처리 > } >
2.2 throw 문을 통한 오류 발생
function validateAge(age) {
if (typeof age !== "number") {
throw new TypeError("나이는 숫자여야 합니다.");
}
if (age < 0) {
throw new RangeError("나이는 음수일 수 없습니다.");
}
return age;
}
- 사용자 정의 오류 객체 생성 가능
Error,SyntaxError등 내장 클래스 활용 권장
2.3 비동기 처리 오류
async function fetchData() {
try {
const response = await fetch("https://api.example.com/data");
if (!response.ok) throw new Error("네트워크 오류");
return response.json();
} catch (error) {
console.error("비동기 오류:", error.message);
throw error; // 상위 호출자에게 전달
}
}
<a href="/doc/%EA%B8%B0%EC%88%A0/%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D/JavaScript/async%2Fawait" class="wiki-link wiki-link-missing">async/await</a>문법의 경우try...catch로 동기식 처리Promise.prototype.catch()를 통한 체이닝도 가능
3. 디버깅 및 오류 해결
3.1 오류 정보 활용
try {
// 오류 발생 코드
} catch (error) {
console.error("오류 메시지:", error.message);
console.error("오류 스택:", error.stack); // 비표준이지만 유용
}
error.message: 간단한 설명error.stack: 호출 스택 추적 (브라우저/Node.js 환경별 차이 존재)
3.2 디버깅 도구
- 브라우저 개발자 도구: 소스 코드 중단점 설정
- Node.js 디버거:
node --inspect옵션 사용 - 로그 라이브러리:
winston,pino등 구조화된 로깅
4. 모범 사례 및 팁
| 항목 | 설명 |
|---|---|
| 1. 명확한 오류 메시지 | "Uncaught Error" 대신 "사용자 ID가 유효하지 않음"과 같은 구체적 메시지 사용 |
| 2. 예외의 과도한 사용 금지 | 일반적인 조건 처리에 try...catch 사용 지양 |
| 3. 오류 타입 구체화 | catch (error) 대신 catch (error instanceof TypeError) 사용 |
| 4. finally의 중요성 | 리소스 해제(파일 닫기, 네트워크 연결 종료 등) 반드시 처리 |
| 5. 글로벌 오류 처리 | window.onerror 또는 process.on('uncaughtException')로 치명적 오류 모니터링 |
💡 성능 최적화: 오류 처리 코드가 성능에 영향을 주지 않도록 최소화합니다.
5. 관련 문서 및 참고 자료
이 문서는 JavaScript 개발자들이 안정적인 코드를 작성하고 예측 가능한 오류를 관리하는 데 도움을 주고자 합니다. 오류 처리는 단순한 예외 회피가 아닌, 시스템의 견고성을 강화하는 핵심 요소입니다.
데이터 라벨링 과정의 오류 처리
데이터셋 구축 단계에서 발생하는 오류는 모델의 성능과 직접적으로 연결되므로, 체계적인 검출 프로세스가 필요합니다.
라벨링 오류의 정의
- 오분류(Misclassification): 정답 라벨이 잘못 지정된 경우 (예: '고양이' 사진에 '강아지' 라벨 부여)
- 누락(Omission): 라벨링해야 할 대상이 누락된 경우 (예: 이미지 내 객체가 존재함에도 바운딩 박스가 없는 경우)
- 일관성 결여(Inconsistency): 동일한 기준의 데이터에 대해 작업자마다 서로 다른 라벨을 부여한 경우
라벨링 오류 검출 체크리스트
검수자는 다음 항목을 기준으로 데이터 품질을 점검합니다. - [ ] 가이드라인 준수: 정의된 라벨링 규칙과 가이드라인을 엄격히 따랐는가? - [ ] 경계 정확도: (객체 검출의 경우) 바운딩 박스나 세그멘테이션 영역이 객체 외곽선에 밀착되었는가? - [ ] 라벨 일치성: 동일한 특성을 가진 데이터들이 모두 동일한 클래스로 분류되었는가? - [ ] 누락 여부: 이미지/텍스트 내에 라벨링 대상이 누락된 영역은 없는가? - [ ] 상호 배타성: 하나의 데이터에 중복되거나 모순되는 라벨이 동시에 부여되지 않았는가?
라벨링 오류 해결 전략
검출된 오류를 수정하고 데이터의 신뢰도를 높이기 위해 다음과 같은 방법론을 적용합니다.
다수결 투표 (Majority Voting)
동일한 데이터에 대해 여러 명의 작업자가 라벨링을 수행하고, 가장 많이 선택된 라벨을 최종 정답으로 채택하는 방식입니다.
계산식: 최종 라벨 $L^*$은 다음과 같이 결정됩니다. $$L^* = \text{mode}(\{l_1, l_2, \dots, l_n\})$$ (여기서 $l_i$는 $i$번째 작업자가 부여한 라벨이며, $\text{mode}$는 최빈값을 의미함)
만약 투표 결과가 동률이거나 합의 수준(Agreement Rate)이 임계값 $\tau$보다 낮을 경우, 전문가 재검수로 이관합니다. $$\text{Agreement Rate} = \frac{\text{count}(L^*)}{n} < \tau \implies \text{Expert Review}$$
기타 수정 방법론
- 전문가 재검수 (Gold Standard): 도메인 전문가가 직접 정답(Gold Set)을 작성하고, 작업자의 결과물과 비교하여 오류를 수정합니다.
- 교차 검증 (Cross-Validation): 작업자 A가 라벨링한 데이터를 작업자 B가 검수하고, 이견이 있을 경우 제3자가 중재하는 프로세스를 거칩니다.
데이터 품질 관리 실무
데이터 기반 애플리케이션에서는 런타임 오류뿐만 아니라 데이터 자체의 품질 오류를 관리하는 것이 중요합니다.
데이터 정제 전후 품질 비교 지표
정제 프로세스의 효과를 측정하기 위해 다음과 같은 지표를 명시하고 비교합니다.
| 지표 | 설명 | 계산 방식 |
|---|---|---|
| 정확도 (Accuracy) | 전체 데이터 중 정답 라벨의 비율 | $\frac{\text{Correct Labels}}{\text{Total Labels}}$ |
| 정밀도 (Precision) | 특정 클래스로 예측한 것 중 실제 정답의 비율 | $\frac{TP}{TP + FP}$ |
| 재현율 (Recall) | 실제 정답 중 모델/작업자가 찾아낸 비율 | $\frac{TP}{TP + FN}$ |
| 상호 일치도 (Inter-Rater Reliability) | 작업자 간 라벨링 일치 정도 (Cohen's Kappa 등) | $\kappa = \frac{p_o - p_e}{1 - p_e}$ |
데이터 품질 관리 참고 자료
오류의 사전 방지 및 예방 전략
런타임에 발생하는 오류를 처리하는 것보다 더 효율적인 방법은 설계 및 개발 단계에서 오류가 발생하지 않도록 원천 차단하는 것입니다.
정적 분석 도구 활용
- TypeScript: 정적 타입 시스템을 도입하여 변수 타입 불일치로 인한
TypeError를 컴파일 단계에서 발견합니다. 특히 타입 가드(Type Guards)를 사용하여 런타임 시 타입의 안전성을 보장할 수 있습니다.
// 타입 가드 예제: 특정 타입인지 확인하여 타입 좁히기(Narrowing) 수행
interface User { name: string; email: string; }
interface Admin { name: string; privileges: string[]; }
function isAdmin(user: User | Admin): user is Admin {
return (user as Admin).privileges !== undefined;
}
function welcomeUser(user: User | Admin) {
if (isAdmin(user)) {
console.log(`관리자님 환영합니다. 권한: ${user.privileges.join(", ")}`);
} else {
console.log(`사용자 ${user.name}님 환영합니다.`);
}
}
- ESLint: 코드 스타일 및 잠재적 버그(사용하지 않는 변수, 도달할 수 없는 코드 등)를 실시간으로 감지하여 구문 오류를 예방합니다.
방어적 프로그래밍 (Defensive Programming)
- 입력값 검증: 외부 API나 사용자로부터 들어오는 데이터는 절대 신뢰하지 않고, 처리 전 반드시 유효성 검사를 수행합니다.
- 불변성 유지:
Object.freeze()나const를 사용하여 상태가 예기치 않게 변경되어 발생하는 논리적 오류를 방지합니다.
데이터 품질 오류 예방 체계
사후 검수 중심의 프로세스는 수정 비용이 높으므로, 데이터 생성 단계에서 오류를 방지하는 'Shift-Left' 전략이 필요합니다.
프로세스 기반 예방
- 가이드라인 구체화: 모호한 표현(예: "적절한 크기로 지정")을 배제하고, 정량적 기준(예: "객체 외곽선에서 2px 이내로 밀착")을 명시한 시각적 가이드라인을 제공합니다.
- 작업자 사전 교육 및 테스트: 실제 작업 투입 전, 정답이 정해진 '골드 셋(Gold Set)'을 통해 작업자의 숙련도를 테스트하고 피드백을 제공합니다.
라벨링 툴의 제약 조건(Constraint) 설정 사례
툴 수준에서 잘못된 입력이 불가능하도록 제약을 설정하여 휴먼 에러를 차단합니다. - 상호 배타적 선택: 'A' 라벨과 'B' 라벨이 동시에 존재할 수 없는 경우, 하나를 선택하면 다른 하나가 자동으로 해제되도록 설정합니다. - 필수 값 지정: 특정 클래스를 선택했을 때 반드시 속성 값(Attribute)을 입력해야만 '저장' 버튼이 활성화되도록 강제합니다. - 범위 제한: 바운딩 박스의 최소/최대 크기를 제한하여, 너무 작거나 이미지 전체를 덮는 비정상적인 라벨링을 방지합니다.
안전한 코딩 패턴 (TypeError 방지)
최신 JavaScript 문법을 활용하여 null이나 undefined 참조로 인한 런타임 붕괴를 방지합니다.
- 옵셔널 체이닝 (
?.): 객체의 깊은 단계에 있는 속성에 접근할 때, 중간 단계가null이나undefined여도 에러를 발생시키지 않고undefined를 반환합니다.// 기존 방식: if (user && user.profile && user.profile.address) ... const city = user?.profile?.address?.city; - 널 병합 연산자 (
??): 변수가null또는undefined일 때만 기본값을 할당합니다. (||연산자와 달리0이나""같은 falsy 값은 유지함)const timeout = config.timeout ?? 3000; // timeout이 null/undefined일 때만 3000 적용
자동 검증(Automated Validation) 체계
수동 검수의 한계를 극복하기 위해, 데이터 저장 직후 또는 배치 단위로 실행되는 자동 검증 스크립트를 도입합니다.
자동 검증 스크립트 구현 예시
데이터의 형식적 무결성과 논리적 모순을 검사하는 스크립트를 통해 1차 필터링을 수행합니다.
/**
* 라벨링 데이터 논리 검증 스크립트
*/
function validateLabelingData(data) {
const errors = [];
data.forEach((item, index) => {
// 1. 형식 검증: 바운딩 박스 좌표가 이미지 범위를 벗어났는가?
if (item.bbox.x < 0 || item.bbox.x > item.imageWidth) {
errors.push({ index, message: "BBox X 좌표 범위 초과" });
}
// 2. 논리 검증: '사람' 라벨이면서 '나이' 속성이 누락되었는가?
if (item.label === 'person' && !item.attributes.age) {
errors.push({ index, message: "사람 클래스에 나이 속성 누락" });
}
// 3. 모순 검증: 상호 배타적 라벨이 동시에 존재하는가?
if (item.labels.includes('indoor') && item.labels.includes('outdoor')) {
errors.push({ index, message: "실내/실외 라벨 중복 부여" });
}
});
return {
isValid: errors.length === 0,
errors: errors
};
}
- 실시간 검증: 작업자가 '저장' 버튼을 누르는 시점에 스크립트를 실행하여 즉시 수정 요청.
- 배치 검증: 전체 데이터셋을 대상으로 주기적으로 실행하여 품질 통계 산출 및 이상치(Outlier) 탐지.
이 문서는 AI 모델(gemma-4-31b)에 의해 생성된 콘텐츠입니다.
주의사항: AI가 생성한 내용은 부정확하거나 편향된 정보를 포함할 수 있습니다. 중요한 결정을 내리기 전에 반드시 신뢰할 수 있는 출처를 통해 정보를 확인하시기 바랍니다.