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
2025-07-31 19:15:39 +09:00
parent ad2c699ff7
commit f08b7fec79
89 changed files with 10521 additions and 892 deletions

View File

@@ -18,7 +18,7 @@ class Environment {
/// API 베이스 URL
static String get apiBaseUrl {
return dotenv.env['API_BASE_URL'] ?? 'http://localhost:8080/api/v1';
return dotenv.env['API_BASE_URL'] ?? 'https://superport.naturebridgeai.com/api/v1';
}
/// API 타임아웃 (밀리초)
@@ -33,16 +33,49 @@ class Environment {
return loggingStr.toLowerCase() == 'true';
}
/// API 사용 여부 (false면 Mock 데이터 사용)
static bool get useApi {
final useApiStr = dotenv.env['USE_API'];
print('[Environment] USE_API 원시값: $useApiStr');
if (useApiStr == null || useApiStr.isEmpty) {
print('[Environment] USE_API가 설정되지 않음, 기본값 true 사용');
return true;
}
final result = useApiStr.toLowerCase() == 'true';
print('[Environment] USE_API 최종값: $result');
return result;
}
/// 환경 초기화
static Future<void> initialize([String? environment]) async {
_environment = environment ??
const String.fromEnvironment('ENVIRONMENT', defaultValue: dev);
final envFile = _getEnvFile();
print('[Environment] 환경 초기화 중...');
print('[Environment] 현재 환경: $_environment');
print('[Environment] 환경 파일: $envFile');
try {
await dotenv.load(fileName: envFile);
print('[Environment] 환경 파일 로드 성공');
// 모든 환경 변수 출력
print('[Environment] 로드된 환경 변수:');
dotenv.env.forEach((key, value) {
print('[Environment] $key: $value');
});
print('[Environment] --- 설정 값 확인 ---');
print('[Environment] API Base URL: ${dotenv.env['API_BASE_URL'] ?? '설정되지 않음'}');
print('[Environment] API Timeout: ${dotenv.env['API_TIMEOUT'] ?? '설정되지 않음'}');
print('[Environment] 로깅 활성화: ${dotenv.env['ENABLE_LOGGING'] ?? '설정되지 않음'}');
print('[Environment] API 사용 (원시값): ${dotenv.env['USE_API'] ?? '설정되지 않음'}');
print('[Environment] API 사용 (getter): $useApi');
} catch (e) {
print('Failed to load env file $envFile: $e');
print('[Environment] ⚠️ 환경 파일 로드 실패: $envFile');
print('[Environment] 에러 상세: $e');
print('[Environment] 기본값을 사용합니다.');
// .env 파일이 없어도 계속 진행
}
}

View 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;
}
}

View File

@@ -0,0 +1,61 @@
import 'package:freezed_annotation/freezed_annotation.dart';
/// 서버와 클라이언트 간 장비 상태 코드 변환 유틸리티
class EquipmentStatusConverter {
/// 서버 상태 코드를 클라이언트 상태 코드로 변환
static String serverToClient(String? serverStatus) {
if (serverStatus == null) return 'E';
switch (serverStatus.toLowerCase()) {
case 'available':
return 'I'; // 입고
case 'inuse':
return 'T'; // 대여
case 'maintenance':
return 'R'; // 수리
case 'disposed':
return 'D'; // 손상
default:
return 'E'; // 기타
}
}
/// 클라이언트 상태 코드를 서버 상태 코드로 변환
static String clientToServer(String? clientStatus) {
if (clientStatus == null) return 'available';
switch (clientStatus) {
case 'I': // 입고
return 'available';
case 'O': // 출고
return 'available';
case 'T': // 대여
return 'inuse';
case 'R': // 수리
return 'maintenance';
case 'D': // 손상
return 'disposed';
case 'L': // 분실
return 'disposed';
case 'E': // 기타
return 'available';
default:
return 'available';
}
}
}
/// Freezed JsonConverter for equipment status
class EquipmentStatusJsonConverter implements JsonConverter<String, String> {
const EquipmentStatusJsonConverter();
@override
String fromJson(String json) {
return EquipmentStatusConverter.serverToClient(json);
}
@override
String toJson(String object) {
return EquipmentStatusConverter.clientToServer(object);
}
}

View File

@@ -0,0 +1,335 @@
import 'package:dio/dio.dart';
import 'package:flutter/foundation.dart';
import 'package:superport/core/utils/debug_logger.dart';
import 'package:superport/core/config/environment.dart' as env;
/// 로그인 문제 진단을 위한 유틸리티 클래스
class LoginDiagnostics {
/// 로그인 프로세스 전체 진단
static Future<Map<String, dynamic>> runFullDiagnostics() async {
final results = <String, dynamic>{};
try {
// 1. 환경 설정 확인
results['environment'] = _checkEnvironment();
// 2. 네트워크 연결 확인
results['network'] = await _checkNetworkConnectivity();
// 3. API 엔드포인트 확인
results['apiEndpoint'] = await _checkApiEndpoint();
// 4. 모델 직렬화 테스트
results['serialization'] = _testSerialization();
// 5. 저장소 접근 테스트
results['storage'] = await _testStorageAccess();
DebugLogger.log(
'로그인 진단 완료',
tag: 'DIAGNOSTICS',
data: results,
);
return results;
} catch (e, stackTrace) {
DebugLogger.logError(
'진단 중 오류 발생',
error: e,
stackTrace: stackTrace,
);
return {
'error': e.toString(),
'stackTrace': stackTrace.toString(),
};
}
}
/// 환경 설정 확인
static Map<String, dynamic> _checkEnvironment() {
return {
'useApi': env.Environment.useApi,
'apiBaseUrl': env.Environment.apiBaseUrl,
'isDebugMode': kDebugMode,
'platform': defaultTargetPlatform.toString(),
};
}
/// 네트워크 연결 확인
static Future<Map<String, dynamic>> _checkNetworkConnectivity() async {
final dio = Dio();
final results = <String, dynamic>{};
try {
// Google DNS로 연결 테스트
final response = await dio.get('https://dns.google/resolve?name=google.com');
results['internetConnection'] = response.statusCode == 200;
} catch (e) {
results['internetConnection'] = false;
results['error'] = e.toString();
}
// API 서버 연결 테스트
if (env.Environment.useApi) {
try {
final response = await dio.get(
'${env.Environment.apiBaseUrl}/health',
options: Options(
validateStatus: (status) => status != null && status < 500,
),
);
results['apiServerReachable'] = true;
results['apiServerStatus'] = response.statusCode;
} catch (e) {
results['apiServerReachable'] = false;
results['apiServerError'] = e.toString();
}
}
return results;
}
/// API 엔드포인트 확인
static Future<Map<String, dynamic>> _checkApiEndpoint() async {
if (!env.Environment.useApi) {
return {'mode': 'mock', 'skip': true};
}
final dio = Dio();
final results = <String, dynamic>{};
try {
// OPTIONS 요청으로 CORS 확인
final response = await dio.request(
'${env.Environment.apiBaseUrl}/auth/login',
options: Options(
method: 'OPTIONS',
validateStatus: (status) => true,
),
);
results['corsEnabled'] = response.statusCode == 200 || response.statusCode == 204;
results['allowedMethods'] = response.headers['access-control-allow-methods'];
results['allowedHeaders'] = response.headers['access-control-allow-headers'];
// 실제 로그인 엔드포인트 테스트 (잘못된 자격 증명으로)
final loginResponse = await dio.post(
'${env.Environment.apiBaseUrl}/auth/login',
data: {
'email': 'test@test.com',
'password': 'test',
},
options: Options(
validateStatus: (status) => true,
),
);
results['loginEndpointStatus'] = loginResponse.statusCode;
results['loginResponseType'] = loginResponse.data?.runtimeType.toString();
// 응답 구조 분석
if (loginResponse.data is Map) {
final data = loginResponse.data as Map;
results['responseKeys'] = data.keys.toList();
results['hasSuccessField'] = data.containsKey('success');
results['hasDataField'] = data.containsKey('data');
results['hasAccessToken'] = data.containsKey('accessToken') || data.containsKey('access_token');
}
} catch (e) {
results['error'] = e.toString();
if (e is DioException) {
results['dioErrorType'] = e.type.toString();
results['dioMessage'] = e.message;
}
}
return results;
}
/// 모델 직렬화 테스트
static Map<String, dynamic> _testSerialization() {
final results = <String, dynamic>{};
try {
// LoginRequest 테스트
results['loginRequestValid'] = true;
// LoginResponse 테스트 (형식 1)
final loginResponse1 = {
'success': true,
'data': {
'accessToken': 'test_token',
'refreshToken': 'refresh_token',
'tokenType': 'Bearer',
'expiresIn': 3600,
'user': {
'id': 1,
'username': 'testuser',
'email': 'test@example.com',
'name': '테스트',
'role': 'USER',
},
},
};
results['format1Valid'] = _validateResponseFormat1(loginResponse1);
// LoginResponse 테스트 (형식 2)
final loginResponse2 = {
'accessToken': 'test_token',
'refreshToken': 'refresh_token',
'tokenType': 'Bearer',
'expiresIn': 3600,
'user': {
'id': 1,
'username': 'testuser',
'email': 'test@example.com',
'name': '테스트',
'role': 'USER',
},
};
results['format2Valid'] = _validateResponseFormat2(loginResponse2);
} catch (e) {
results['error'] = e.toString();
}
return results;
}
/// 저장소 접근 테스트
static Future<Map<String, dynamic>> _testStorageAccess() async {
final results = <String, dynamic>{};
try {
// 실제 FlutterSecureStorage 테스트는 의존성 주입이 필요하므로
// 여기서는 기본적인 체크만 수행
results['platformSupported'] = true;
// 플랫폼별 특이사항 체크
if (defaultTargetPlatform == TargetPlatform.iOS) {
results['note'] = 'iOS Keychain 사용';
} else if (defaultTargetPlatform == TargetPlatform.android) {
results['note'] = 'Android KeyStore 사용';
} else {
results['note'] = '웹 또는 데스크톱 플랫폼';
}
} catch (e) {
results['error'] = e.toString();
}
return results;
}
/// 응답 형식 1 검증
static bool _validateResponseFormat1(Map<String, dynamic> response) {
try {
if (!response.containsKey('success') || response['success'] != true) {
return false;
}
if (!response.containsKey('data') || response['data'] is! Map) {
return false;
}
final data = response['data'] as Map<String, dynamic>;
final requiredFields = ['accessToken', 'refreshToken', 'user'];
for (final field in requiredFields) {
if (!data.containsKey(field)) {
return false;
}
}
return true;
} catch (e) {
return false;
}
}
/// 응답 형식 2 검증
static bool _validateResponseFormat2(Map<String, dynamic> response) {
try {
final requiredFields = ['accessToken', 'refreshToken', 'user'];
for (final field in requiredFields) {
if (!response.containsKey(field)) {
return false;
}
}
if (response['user'] is! Map) {
return false;
}
return true;
} catch (e) {
return false;
}
}
/// 진단 결과를 읽기 쉬운 형식으로 포맷
static String formatDiagnosticsReport(Map<String, dynamic> diagnostics) {
final buffer = StringBuffer();
buffer.writeln('=== 로그인 진단 보고서 ===\n');
// 환경 설정
if (diagnostics.containsKey('environment')) {
buffer.writeln('## 환경 설정');
final env = diagnostics['environment'] as Map<String, dynamic>;
env.forEach((key, value) {
buffer.writeln('- $key: $value');
});
buffer.writeln();
}
// 네트워크 상태
if (diagnostics.containsKey('network')) {
buffer.writeln('## 네트워크 상태');
final network = diagnostics['network'] as Map<String, dynamic>;
buffer.writeln('- 인터넷 연결: ${network['internetConnection'] == true ? '' : ''}');
if (network.containsKey('apiServerReachable')) {
buffer.writeln('- API 서버 접근: ${network['apiServerReachable'] == true ? '' : ''}');
}
buffer.writeln();
}
// API 엔드포인트
if (diagnostics.containsKey('apiEndpoint')) {
buffer.writeln('## API 엔드포인트');
final api = diagnostics['apiEndpoint'] as Map<String, dynamic>;
if (api['skip'] == true) {
buffer.writeln('- Mock 모드로 건너뜀');
} else {
buffer.writeln('- CORS 활성화: ${api['corsEnabled'] == true ? '' : ''}');
buffer.writeln('- 로그인 엔드포인트 상태: ${api['loginEndpointStatus']}');
if (api.containsKey('responseKeys')) {
buffer.writeln('- 응답 키: ${api['responseKeys']}');
}
}
buffer.writeln();
}
// 직렬화 테스트
if (diagnostics.containsKey('serialization')) {
buffer.writeln('## 모델 직렬화');
final serial = diagnostics['serialization'] as Map<String, dynamic>;
buffer.writeln('- LoginRequest: ${serial['loginRequestValid'] == true ? '' : ''}');
buffer.writeln('- 응답 형식 1: ${serial['format1Valid'] == true ? '' : ''}');
buffer.writeln('- 응답 형식 2: ${serial['format2Valid'] == true ? '' : ''}');
buffer.writeln();
}
// 오류 정보
if (diagnostics.containsKey('error')) {
buffer.writeln('## ⚠️ 오류 발생');
buffer.writeln(diagnostics['error']);
}
return buffer.toString();
}
}