JSP 404 경로 오류: 로컬 개발 환경 점검법

로컬 개발 환경에서 배포는 성공했지만 JSP URL이 404를 반환합니다. 때 원인을 좁히고 안전하게 수정한 뒤 재발 여부까지 확인하는 순서입니다.

JSPWindows · macOS · Linux

짧은 요약

배포는 성공했지만 JSP URL이 404를 반환합니다. 문제는 임시 우회보다 실행 환경과 최초 오류를 먼저 고정해야 재발을 막을 수 있습니다. 배포된 context와 라우팅 기준으로 URL을 맞추고 WAR 내부 경로를 확인합니다.

Tomcat 9·10과 Servlet/JSP 웹 애플리케이션에서 배포는 성공했지만 JSP URL이 404를 반환합니다. 상황이 나타납니다. 오류가 난 시각, 전체 메시지, 직전 변경과 실제 실행 버전을 함께 기록합니다.

context path, servlet mapping, 실제 WAR 경로가 맞지 않습니다. 같은 문구라도 로컬과 배포 환경의 실행 파일, 의존성, 환경변수가 다르면 원인이 달라질 수 있습니다. 로컬 실행 명령과 IDE가 같은 런타임을 가리키는지 비교합니다.

영향이 제한된 테스트 환경에서 정상 입력과 실패 입력을 하나씩 준비합니다. 설정을 여러 개 바꾸지 말고 오류가 처음 달라지는 단계의 출력과 종료 코드를 비교합니다. 운영 비밀번호·토큰·개인정보는 예제와 로그에서 제거합니다.

1. 오류 원문의 가장 안쪽 원인과 발생 시각을 보존합니다.

2. 실제 실행 중인 JSP 버전, 작업 디렉터리와 배포 산출물을 확인합니다.

3. 배포된 context와 라우팅 기준으로 URL을 맞추고 WAR 내부 경로를 확인합니다.

4. 변경 하나마다 같은 입력을 다시 실행하고 결과를 기록합니다.

5. 새 세션 또는 깨끗한 배포 환경에서 같은 해결이 유지되는지 확인합니다.

jar tf app.war | grep "WEB-INF|.jsp"
curl -I http://<host>:8080/<context>/page.jsp

예문의 <PID>, <host>, <path>, <context>는 실제 값으로 바꿉니다. 먼저 조회 명령으로 대상을 확인한 뒤 변경합니다.

재기동 후 context 로그와 HTTP 상태를 확인합니다. 이어서 관련 자동 테스트를 두 번 실행하고 새 오류나 경고가 추가되지 않았는지 확인합니다.

검증 비활성화, 무조건적인 관리자 권한 실행, 전체 캐시 삭제는 해결책으로 삼지 않습니다. 운영 반영 전에는 변경 범위와 되돌릴 지점을 남기고, 사용 중인 버전의 공식 문서에서 옵션 지원 여부를 확인합니다.