오류 보안
규칙
- 프로덕션 환경에서 클라이언트로 스택 트레이스, 데이터베이스 오류 또는 파일 경로를 절대 누출하지 않음
- 고유한 오류 ID와 함께 일반적인 오류 메시지 반환:
{ error: "문제가 발생했습니다", errorId: "abc123" }
- 디버깅을 위해 동일한 상관관계 ID로 서버 측에 전체 오류 상세 정보 기록
- 오류 상세 수준 구분: 개발 환경(전체 스택 트레이스) vs 프로덕션 환경(안전한 메시지 + ID)
- 전역 오류 핸들러로 처리되지 않은 모든 오류를 포착 — 절대 원시 오류가 클라이언트에 도달하지 않도록 함
- 클라이언트로 전달하기 전에 타사 서비스의 오류 메시지를 정화
- 적절한 HTTP 상태 코드 반환: 400 (잘못된 입력), 401 (인증되지 않음), 403 (금지됨), 404 (찾을 수 없음), 500 (서버 오류)
import { randomUUID } from "node:crypto";
app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
const errorId = randomUUID();
console.error({ errorId, message: err.message, stack: err.stack, url: req.url });
const statusCode = (err as any).statusCode || 500;
res.status(statusCode).json({
error: statusCode >= 500 ? "내부 서버 오류" : err.message,
errorId,
...(process.env.NODE_ENV === "development" && { stack: err.stack }),
});
});
import { useEffect } from 'react';
export default function GlobalError({ error, reset }) {
useEffect(() => {
console.error(error);
}, [error]);
return (
<div>
<h2>문제가 발생했습니다</h2>
<p>오류 ID: {error.digest}</p>
<button onClick={reset}>다시 시도</button>
</div>
);
}
피해야 할 사항
err.message를 직접 반환 — 데이터베이스 오류는 테이블 이름, 열 이름 및 쿼리 구조를 누출함
- 프로덕션 응답에 스택 트레이스 포함 — 파일 경로, 종속성 및 내부 아키텍처를 드러냄
- 모든 것에 일반적인 500 사용 — 클라이언트가 오류를 적절히 처리할 수 있도록 적절한 상태 코드 사용
- 상관관계 ID 없이 오류 기록 — 프로덕션 디버깅을 거의 불가능하게 만듦
- 오류를 조용히 무시 — 응답이 일반적이더라도 항상 기록