REST API 주니어 트러블슈팅 면접

현재 문제는 클라이언트의 잘못된 요청에 대해 500 에러를 반환하고 있다는 점입니다. 필수 필드 누락은 클라이언트 오류이므로 400 Bad Request를 반환해야 합니다. 서버 코드에서 요청 데이터 검증 로직을 추가하여 필수 필드가 누락된 경우 적절한 에러 메시지와 함께 400 상태 코드를 반환하도록 수정해야 합니다. 또한 예외 처리를 통해 예상치 못한 에러만 500으로 반환되도록 해야 합니다. 재발 방지를 위해 API 문서에 필수 필드를 명확히 기재하고, 입력 값 검증 테스트 케이스를 추가해야 합니다.

먼저 데이터베이스 슬로우 쿼리 로그를 확인하여 실행 시간이 긴 쿼리를 식별합니다. 상품 테이블의 데이터 증가량을 확인하고, 인덱스가 제대로 적용되어 있는지 EXPLAIN 명령어로 쿼리 실행 계획을 분석합니다. 만약 인덱스가 없거나 Full Table Scan이 발생한다면 적절한 인덱스를 추가합니다. 또한 페이지네이션이 적용되어 있는지 확인하고, 없다면 LIMIT/OFFSET을 적용하여 한 번에 조회하는 데이터 양을 제한합니다. 해결 후에는 API 응답 시간 모니터링을 설정하여 성능 저하를 조기에 감지할 수 있도록 합니다.

브라우저는 보안상의 이유로 다른 출처(origin)의 리소스 접근을 제한하는 동일 출처 정책(Same-Origin Policy)을 적용하지만, Postman은 이 정책을 적용하지 않기 때문에 차이가 발생합니다. 해결하려면 서버에서 CORS 헤더를 설정해야 합니다. Access-Control-Allow-Origin 헤더에 허용할 출처를 명시하고, Access-Control-Allow-Methods에 허용할 HTTP 메서드를, Access-Control-Allow-Headers에 허용할 헤더를 설정합니다. 개발 환경에서는 localhost:3000을 허용하고, 프로덕션에서는 실제 프론트엔드 도메인만 허용하도록 환경별로 설정을 분리해야 합니다.

첫 번째로 토큰의 만료 시간(exp claim)을 확인하여 토큰이 만료되었는지 체크합니다. 만료되었다면 클라이언트에서 리프레시 토큰으로 새 액세스 토큰을 발급받도록 해야 합니다. 두 번째로 토큰의 페이로드에 담긴 사용자 정보(user_id 등)가 실제 데이터베이스에 존재하는지 확인합니다. 사용자가 삭제되었거나 비활성화된 경우 토큰은 유효하지만 인증에 실패할 수 있습니다. 세 번째로 서버의 시스템 시간이 정확한지 확인합니다. 시간이 맞지 않으면 토큰 유효성 검증에 문제가 생길 수 있습니다. 재발 방지를 위해 토큰 검증 로직에 명확한 에러 메시지를 추가하여 어떤 이유로 인증에 실패했는지 로그에 기록해야 합니다.

이 문제는 동시성 제어가 되지 않아 발생하는 Race Condition입니다. 여러 요청이 동시에 재고를 조회하면 모두 10개로 읽고, 각각 차감 연산을 수행하여 재고가 음수가 되거나 초과 판매가 발생합니다. 해결 방법으로는 데이터베이스의 비관적 락(SELECT FOR UPDATE)을 사용하여 재고 조회 시 해당 row를 잠그는 방법이 있습니다. 또는 낙관적 락(버전 관리)을 사용하여 업데이트 시 버전을 확인하고 충돌 시 재시도하는 방법도 있습니다. 더 간단한 방법으로는 UPDATE 쿼리에서 WHERE 조건에 재고 체크를 포함시켜(WHERE stock >= 주문수량) 원자적으로 처리하고, 영향받은 행이 0이면 재고 부족으로 처리할 수 있습니다. 재발 방지를 위해 통합 테스트에서 동시성 시나리오를 테스트해야 합니다.