Java: 의존 모듈을 찾지 못해 실행이 중단됨: 원인과 해결 순서

Java: 의존 모듈을 찾지 못해 실행이 중단됨의 대표 원인을 구분하고 안전하게 재현·수정·검증하는 순서를 정리합니다.

JavaCross-platform

짧은 요약

Java: 의존 모듈을 찾지 못해 실행이 중단됨은(는) 설정을 무작정 초기화하기보다 실행 환경과 오류 경계를 먼저 확인해야 안전하게 해결할 수 있습니다. 현재 인터프리터·런타임과 패키지 설치 경로를 확인하고 잠금 파일 기준으로 다시 설치하는 순서로 접근합니다.

Java: 의존 모듈을 찾지 못해 실행이 중단됨. 먼저 오류 전문, 실행 계정, 도구 버전, 발생 시각을 함께 기록합니다.

패키지를 설치한 실행 환경과 애플리케이션을 시작한 환경이 다르거나, 잠금 파일과 설치 결과가 어긋난 경우가 많습니다.

깨끗한 작업 디렉터리에서 잠금 파일을 유지한 채 의존성을 다시 설치하고 같은 실행 명령으로 오류를 재현합니다.

1. 오류 전문에서 최초로 찾지 못한 패키지와 import 경로를 기록합니다.

2. 실행 파일과 패키지 관리 도구가 같은 런타임을 가리키는지 확인합니다.

3. 잠금 파일을 임의로 지우지 말고 재현 가능한 설치 명령을 사용합니다.

4. 직접 의존성과 전이 의존성을 구분한 뒤 필요한 패키지만 수정합니다.

./mvnw dependency:tree
./mvnw -q test

명령의 <command>, <path>, <domain>, <PID>, <package>는 실제 값으로 바꿉니다. 변경 명령을 실행하기 전에 위 진단 결과부터 확인하세요.

의존성 검사 명령과 테스트를 연속 두 번 실행해 모두 통과하고, 새 작업 디렉터리에서도 같은 결과인지 확인합니다.

권한 오류를 피하려고 전역 설치나 관리자 권한 설치로 우회하지 마세요. 프로젝트별 의존성 경계를 먼저 복구해야 합니다.