로그가 길게 나와도 겁먹지 않아도 됩니다. 핵심은 **"전부 읽는 게 아니라, 어디를 볼지 아는 것"**입니다.
Step 1: 에러 메시지 첫 줄 읽기 (뭐가 잘못됐는지)
↓
Step 2: 에러 종류(Exception Type) 확인 (어떤 종류의 문제인지)
↓
Step 3: 파일명 + 줄 번호 찾기 (어디서 터졌는지)
↓
Step 4: Stack Trace에서 "내 코드" 찾기 (원인이 어디인지)
↓
Step 5: 관련 로그에서 직전 상황 확인 (왜 터졌는지)
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 프레임워크 내부 코드이므로 보통 무시해도 됩니다.
| 에러 | 의미 | 해결 방향 |
|---|---|---|
SQLSTATE[23000] Integrity constraint violation |
유니크 제약 위반, 외래키 위반 등 | 중복 데이터 확인, FK 관계 확인 |
SQLSTATE[42S22] Column not found |
존재하지 않는 컬럼 참조 | 마이그레이션 확인, 컬럼명 오타 확인 |
SQLSTATE[42S02] Table not found |
테이블이 없음 | 마이그레이션 실행 여부 확인 |
Deadlock found |
동시에 같은 레코드를 수정하려 함 | 트랜잭션 범위 확인, 재시도 로직 검토 |
| 에러 | 의미 | 해결 방향 |
|---|---|---|
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 컨테이너에서 클래스 해석 실패 | 바인딩, 컨트롤러 경로 확인 |