/** * 에러 핸들러 미들웨어 * * 애플리케이션 전역 에러를 처리하는 Express 미들웨어 * * @author TK-FB-Project * @since 2025-12-11 */ const { AppError } = require('../utils/errors'); const logger = require('../utils/logger'); /** * 에러 응답 포맷터 */ const formatErrorResponse = (error, req) => { const response = { success: false, error: { message: error.message || '알 수 없는 오류가 발생했습니다', code: error.code || 'INTERNAL_ERROR' }, timestamp: new Date().toISOString() }; // 검증 에러의 경우 상세 정보 포함 if (error.details) { response.error.details = error.details; } // 개발 환경에서만 스택 트레이스 포함 if (process.env.NODE_ENV === 'development') { response.error.stack = error.stack; response.request = { method: req.method, url: req.originalUrl, ip: req.ip, user: req.user?.username || 'anonymous' }; } return response; }; /** * 에러 핸들러 미들웨어 */ const errorHandler = (error, req, res, next) => { // AppError가 아닌 경우 변환 if (!(error instanceof AppError)) { error = new AppError( error.message || '서버 내부 오류가 발생했습니다', 500, 'INTERNAL_ERROR' ); } // 로깅 if (error.statusCode >= 500) { logger.error(error.message, { code: error.code, stack: error.stack, url: req.originalUrl, method: req.method, user: req.user?.username || 'anonymous' }); } else { logger.warn(error.message, { code: error.code, url: req.originalUrl, method: req.method, user: req.user?.username || 'anonymous' }); } // 응답 const response = formatErrorResponse(error, req); res.status(error.statusCode).json(response); }; /** * 비동기 함수 래퍼 (에러 자동 처리) */ const asyncHandler = (fn) => { return (req, res, next) => { Promise.resolve(fn(req, res, next)).catch(next); }; }; /** * 404 Not Found 핸들러 */ const notFoundHandler = (req, res, next) => { const { NotFoundError } = require('../utils/errors'); next(new NotFoundError(`경로를 찾을 수 없습니다: ${req.originalUrl}`)); }; module.exports = { errorHandler, asyncHandler, notFoundHandler };