Eclipse 프로젝트 Source 폴더에 지정한 서블릿이 웹서비스에서 인식하지 않는 문제

이 문제는 Java 웹 애플리케이션에서 프로젝트의 빌드 경로와 Tomcat 서버 설정이 어떻게 동작하는지와 관련이 있습니다.

원인 분석

1. 빌드 경로 차이
   main 폴더는 일반적으로 프로덕션 코드를 포함하며, 이를 Tomcat 서버가 실행 시 배포 경로에 포함시킵니다.
   반면, test 폴더는 일반적으로 테스트 코드를 포함하는데, 이는 Tomcat이 배포 경로로 포함하지 않습니다. 따라서 test 폴더에 있는 서블릿 클래스는 Tomcat 서버에 의해 로드되지 않습니다.

2. Tomcat 배포 시 컨텍스트 경로에 포함되지 않음

   • Tomcat은 WEB-INF/classes에 위치한 클래스를 기본적으로 읽어들입니다.
   • test 폴더는 Maven 표준 디렉터리 구조나 Eclipse의 프로젝트 구성 상, 테스트 코드만을 포함하며 빌드 아티팩트로 배포되지 않습니다.

3. 웹 애플리케이션 구조의 표준화
   Java 웹 애플리케이션에서 서블릿 클래스는 일반적으로 src/main/java에 위치해야 합니다.
   src/test/java는 단위 테스트용 코드만 포함하도록 설계되었습니다.

해결 방법

1. 서블릿 클래스를 src/main/java로 이동

• 서블릿 클래스는 반드시 src/main/java에 위치해야 Tomcat이 이를 인식하고 요청에 응답할 수 있습니다.
• src/test/java에 위치한 클래스는 테스트 실행 시만 사용되므로, 실제 서버 배포 시 포함되지 않습니다.

2. 테스트용 서블릿 클래스를 따로 실행하려면

만약 src/test/java에 서블릿 클래스를 유지하고 싶다면, 다음 방법 중 하나를 사용하세요:

(1) test 디렉토리를 배포 경로에 포함

• Eclipse에서 Java Build Path를 열어 Source 탭에서 src/test/java를 추가합니다.
• 이후 프로젝트를 빌드하고 Tomcat 서버를 재시작합니다.

하지만, 이는 권장되지 않습니다. 테스트 클래스는 일반적으로 프로덕션 코드와 분리되어야 하기 때문입니다.

(2) 독립적인 테스트 서버 사용

• 테스트 환경에서만 사용할 Tomcat 인스턴스를 별도로 구성하여 테스트 코드를 포함하도록 설정할 수 있습니다.

3. Maven 표준 디렉터리 구조를 유지

Maven 표준 구조를 따른다면:

• 프로덕션 코드는 src/main/java에 위치
• 테스트 코드는 src/test/java에 위치

Maven을 사용 중이라면 mvn clean package로 빌드하면, src/main/java의 코드만 포함됩니다.

추가 확인 사항

• Tomcat 로그 확인:
  Tomcat 실행 로그에 클래스 로드 오류나 경로 문제와 관련된 메시지가 출력될 수 있습니다.

• Eclipse 설정 확인:

  • Deployment Assembly에서 src/test/java가 배포 경로(WEB-INF/classes)에 포함되지 않는지 확인하세요.

• 정상적인 서블릿 URL 매핑:
  web.xml이나 @WebServlet 애노테이션으로 URL 매핑이 올바르게 설정되어 있는지 확인하세요.

이 설정을 따라도 문제가 해결되지 않으면, 추가적으로 오류 로그를 공유해 주시면 더 자세히 도와드릴 수 있습니다! ????