WEB 500 에러 원인

---

 

🐻 : 웹개발을 하다보면 다양한 오류가 발생하는데, F12 관리자 모드를 선택해서 5XX 에러에 대해서 확인 해볼 수 있다. 일단 500 에러(Internal Server Error)는 서버에서 요청을 처리하는 도중 오류가 발생했을 때 나타나는 HTTP 상태 코드 라고 할수 있다.

 

🔍 1. 서버 코드 오류 (Java, JSP, Spring 등)

• NullPointerException: 객체가 null인 상태에서 메서드를 호출했을 때 발생
• IndexOutOfBoundsException: 배열이나 리스트에서 잘못된 인덱스를 참조할 때 발생
• ClassCastException: 잘못된 형변환 수행 시 발생
• SQL 오류: SQL 문법 오류, 제약 조건 위반, DB 연결 문제 등

🔍 2. 데이터베이스 관련 문제 (PostgreSQL 등)

• DB 연결 실패: DB 서버가 다운되었거나, 잘못된 연결 정보 사용
• 쿼리 실행 오류: 테이블이 없거나 컬럼명이 잘못됨
• 트랜잭션 문제: 롤백이 필요하거나 Deadlock 발생

🔍 3. 웹 서버 또는 WAS 문제 (Tomcat, Nginx 등)

• 서버 설정 오류: server.xml, web.xml 설정 오류
• 메모리 부족: 서버에 메모리가 부족하면 OOM(Out of Memory) 발생
• 포트 충돌: 같은 포트에서 다른 프로세스가 실행 중

🔍 4. 파일 및 권한 문제

• 파일 경로 오류: JSP, HTML, CSS, JS 등의 경로가 잘못됨
• 파일 읽기/쓰기 권한 부족: OS에서 실행 권한이 없음

🔍 5. 잘못된 요청 처리

• JSON 파싱 오류: 프론트에서 잘못된 JSON 형식의 데이터를 보낼 경우
• 인코딩 문제: 요청 데이터가 UTF-8이 아니거나, @RequestBody에서 처리 실패

 

 

---

 

 

 

✅ 해결 방법

1. 서버 로그 확인 (catalina.out, console.log, error.log 등)
2. JSP/Java 코드 디버깅 (try-catch 추가, System.out.println 등)
3. SQL 실행 테스트 (pgAdmin, DBeaver 같은 툴로 직접 실행)
4. 서버 설정 확인 (web.xml, application.properties, server.xml)
5. API 응답 확인 (Postman, DevTools -> Network 탭 활용)