로그 & 에러 읽는 법 — Laravel 백엔드 개발자 가이드

로그가 길게 나와도 겁먹지 않아도 됩니다. 핵심은 **"전부 읽는 게 아니라, 어디를 볼지 아는 것"**입니다.


1. 에러를 만났을 때 보는 순서 (5단계)

Step 1: 에러 메시지 첫 줄 읽기 (뭐가 잘못됐는지)
    ↓
Step 2: 에러 종류(Exception Type) 확인 (어떤 종류의 문제인지)
    ↓
Step 3: 파일명 + 줄 번호 찾기 (어디서 터졌는지)
    ↓
Step 4: Stack Trace에서 "내 코드" 찾기 (원인이 어디인지)
    ↓
Step 5: 관련 로그에서 직전 상황 확인 (왜 터졌는지)

2. 에러 메시지 읽는 법

에러의 구조

Laravel 에러는 보통 이런 형태입니다:

[2025-02-24 10:30:15] production.ERROR: SQLSTATE[23000]:
Integrity constraint violation: 1062 Duplicate entry
'[email protected]' for key 'users_email_unique'
{"exception":"[object] (Illuminate\\Database\\QueryException(code: 23000)
at /app/Http/Controllers/UserController.php:45)
[stacktrace]
#0 /vendor/laravel/framework/src/Illuminate/Database/Connection.php(742)
#1 /vendor/laravel/framework/src/Illuminate/Database/Connection.php(702)
#2 /app/Http/Controllers/UserController.php(45)
#3 /vendor/laravel/framework/src/Illuminate/Routing/Controller.php(54)
...

어디를 봐야 하는가

순서 보는 곳 예시에서 의미
① 에러 타입 SQLSTATE[23000]: Integrity constraint violation DB 제약 조건 위반이라는 뜻
② 에러 메시지 Duplicate entry '[email protected]' for key 'users_email_unique' 이메일이 중복이라는 구체적 원인
③ 내 코드 위치 at /app/Http/Controllers/UserController.php:45 UserController.php의 45번째 줄에서 터짐
④ Stack Trace 중 /app/ 경로 #2 /app/Http/Controllers/UserController.php(45) vendor가 아닌 /app/ 경로가 내 코드

핵심 규칙

Stack Trace가 아무리 길어도, /app/ 경로만 찾으면 됩니다./vendor/ 경로는 Laravel 프레임워크 내부 코드이므로 보통 무시해도 됩니다.


3. Laravel에서 자주 보는 에러 유형

DB/SQL 관련

에러 의미 해결 방향
SQLSTATE[23000] Integrity constraint violation 유니크 제약 위반, 외래키 위반 등 중복 데이터 확인, FK 관계 확인
SQLSTATE[42S22] Column not found 존재하지 않는 컬럼 참조 마이그레이션 확인, 컬럼명 오타 확인
SQLSTATE[42S02] Table not found 테이블이 없음 마이그레이션 실행 여부 확인
Deadlock found 동시에 같은 레코드를 수정하려 함 트랜잭션 범위 확인, 재시도 로직 검토

Laravel 프레임워크 관련

에러 의미 해결 방향
ModelNotFoundException DB에서 해당 레코드를 못 찾음 findOrFail() 사용 시 ID 확인
MethodNotAllowedHttpException HTTP 메서드 불일치 (GET인데 POST로 보냄 등) 라우트 정의와 요청 메서드 확인
TokenMismatchException CSRF 토큰 불일치 폼에 @csrf 확인, 세션 만료 여부
ValidationException 밸리데이션 실패 요청 데이터가 규칙에 맞는지 확인
AuthenticationException 인증 실패 로그인 상태, 토큰 확인
NotFoundHttpException 라우트를 못 찾음 (404) URL, 라우트 정의 확인
Class not found 클래스를 못 찾음 namespace, import, composer dump-autoload
Target class does not exist DI 컨테이너에서 클래스 해석 실패 바인딩, 컨트롤러 경로 확인