fix: API 응답 파싱 오류 수정 및 에러 처리 개선
주요 변경사항: - 창고 관리 API 응답 구조와 DTO 불일치 수정 - WarehouseLocationDto에 code, manager_phone 필드 추가 - RemoteDataSource에서 API 응답을 DTO 구조에 맞게 변환 - 회사 관리 API 응답 파싱 오류 수정 - CompanyResponse의 필수 필드를 nullable로 변경 - PaginatedResponse 구조 매핑 로직 개선 - 에러 처리 및 로깅 개선 - Service Layer에 상세 에러 로깅 추가 - Controller에서 에러 타입별 처리 - 새로운 유틸리티 추가 - ResponseInterceptor: API 응답 정규화 - DebugLogger: 디버깅 도구 - HealthCheckService: 서버 상태 확인 - 문서화 - API 통합 테스트 가이드 - 에러 분석 보고서 - 리팩토링 계획서
This commit is contained in:
JiWoong Sul
214
lib/core/utils/debug_logger.dart
Normal file
214
lib/core/utils/debug_logger.dart
Normal file
@@ -0,0 +1,214 @@
|
||||
import 'dart:convert';
|
||||
import 'dart:developer' as developer;
|
||||
import 'package:flutter/foundation.dart';
|
||||
|
||||
/// 디버깅을 위한 고급 로거 클래스
|
||||
class DebugLogger {
|
||||
static const String _separator = '=================================================='; // 50개의 '='
|
||||
|
||||
/// 디버그 모드에서만 로그 출력
|
||||
static void log(
|
||||
String message, {
|
||||
String? tag,
|
||||
Object? data,
|
||||
StackTrace? stackTrace,
|
||||
bool isError = false,
|
||||
}) {
|
||||
if (!kDebugMode) return;
|
||||
|
||||
final timestamp = DateTime.now().toIso8601String();
|
||||
final logTag = tag ?? 'DEBUG';
|
||||
|
||||
developer.log(
|
||||
'''
|
||||
$_separator
|
||||
[$logTag] $timestamp
|
||||
$message
|
||||
${data != null ? '\nData: ${_formatData(data)}' : ''}
|
||||
${stackTrace != null ? '\nStackTrace:\n$stackTrace' : ''}
|
||||
$_separator
|
||||
''',
|
||||
name: logTag,
|
||||
error: isError ? data : null,
|
||||
stackTrace: isError ? stackTrace : null,
|
||||
time: DateTime.now(),
|
||||
);
|
||||
}
|
||||
|
||||
/// API 요청 로깅
|
||||
static void logApiRequest({
|
||||
required String method,
|
||||
required String url,
|
||||
Map<String, dynamic>? headers,
|
||||
dynamic data,
|
||||
}) {
|
||||
log(
|
||||
'API 요청',
|
||||
tag: 'API_REQUEST',
|
||||
data: {
|
||||
'method': method,
|
||||
'url': url,
|
||||
'headers': headers,
|
||||
'data': data,
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
/// API 응답 로깅
|
||||
static void logApiResponse({
|
||||
required String url,
|
||||
required int? statusCode,
|
||||
Map<String, dynamic>? headers,
|
||||
dynamic data,
|
||||
}) {
|
||||
log(
|
||||
'API 응답',
|
||||
tag: 'API_RESPONSE',
|
||||
data: {
|
||||
'url': url,
|
||||
'statusCode': statusCode,
|
||||
'headers': headers,
|
||||
'data': data,
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
/// 에러 로깅
|
||||
static void logError(
|
||||
String message, {
|
||||
Object? error,
|
||||
StackTrace? stackTrace,
|
||||
Map<String, dynamic>? additionalData,
|
||||
}) {
|
||||
log(
|
||||
'에러 발생: $message',
|
||||
tag: 'ERROR',
|
||||
data: {
|
||||
'error': error?.toString(),
|
||||
'additionalData': additionalData,
|
||||
},
|
||||
stackTrace: stackTrace,
|
||||
isError: true,
|
||||
);
|
||||
}
|
||||
|
||||
/// 로그인 프로세스 전용 로깅
|
||||
static void logLogin(String step, {Map<String, dynamic>? data}) {
|
||||
log(
|
||||
'로그인 프로세스: $step',
|
||||
tag: 'LOGIN',
|
||||
data: data,
|
||||
);
|
||||
}
|
||||
|
||||
/// 데이터 포맷팅
|
||||
static String _formatData(Object data) {
|
||||
try {
|
||||
if (data is Map || data is List) {
|
||||
return const JsonEncoder.withIndent(' ').convert(data);
|
||||
}
|
||||
return data.toString();
|
||||
} catch (e) {
|
||||
return data.toString();
|
||||
}
|
||||
}
|
||||
|
||||
/// 디버그 모드 확인
|
||||
static bool get isDebugMode => kDebugMode;
|
||||
|
||||
/// Assert를 사용한 런타임 검증 (디버그 모드에서만)
|
||||
static void assertValid(
|
||||
bool condition,
|
||||
String message, {
|
||||
Map<String, dynamic>? data,
|
||||
}) {
|
||||
assert(() {
|
||||
if (!condition) {
|
||||
logError('Assertion failed: $message', additionalData: data);
|
||||
}
|
||||
return condition;
|
||||
}(), message);
|
||||
}
|
||||
|
||||
/// JSON 파싱 검증 및 로깅
|
||||
static T? parseJsonWithLogging<T>(
|
||||
dynamic json,
|
||||
T Function(Map<String, dynamic>) parser, {
|
||||
required String objectName,
|
||||
}) {
|
||||
try {
|
||||
if (json == null) {
|
||||
logError('$objectName 파싱 실패: JSON이 null입니다');
|
||||
return null;
|
||||
}
|
||||
|
||||
if (json is! Map<String, dynamic>) {
|
||||
logError(
|
||||
'$objectName 파싱 실패: 잘못된 JSON 형식',
|
||||
additionalData: {
|
||||
'actualType': json.runtimeType.toString(),
|
||||
'expectedType': 'Map<String, dynamic>',
|
||||
},
|
||||
);
|
||||
return null;
|
||||
}
|
||||
|
||||
log(
|
||||
'$objectName 파싱 시작',
|
||||
tag: 'JSON_PARSE',
|
||||
data: json,
|
||||
);
|
||||
|
||||
final result = parser(json);
|
||||
|
||||
log(
|
||||
'$objectName 파싱 성공',
|
||||
tag: 'JSON_PARSE',
|
||||
);
|
||||
|
||||
return result;
|
||||
} catch (e, stackTrace) {
|
||||
logError(
|
||||
'$objectName 파싱 중 예외 발생',
|
||||
error: e,
|
||||
stackTrace: stackTrace,
|
||||
additionalData: {
|
||||
'json': json,
|
||||
},
|
||||
);
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/// 응답 데이터 구조 검증
|
||||
static bool validateResponseStructure(
|
||||
Map<String, dynamic> response,
|
||||
List<String> requiredFields, {
|
||||
String? responseName,
|
||||
}) {
|
||||
final missing = <String>[];
|
||||
|
||||
for (final field in requiredFields) {
|
||||
if (!response.containsKey(field)) {
|
||||
missing.add(field);
|
||||
}
|
||||
}
|
||||
|
||||
if (missing.isNotEmpty) {
|
||||
logError(
|
||||
'${responseName ?? 'Response'} 구조 검증 실패',
|
||||
additionalData: {
|
||||
'missingFields': missing,
|
||||
'actualFields': response.keys.toList(),
|
||||
},
|
||||
);
|
||||
return false;
|
||||
}
|
||||
|
||||
log(
|
||||
'${responseName ?? 'Response'} 구조 검증 성공',
|
||||
tag: 'VALIDATION',
|
||||
);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user