1. 문제 상황 (Problem)
- 현상: STS(Spring Tool Suite)에서
Import Maven Projects를 시도했으나, 리스트에pom.xml은 뜨지만 체크박스가 비활성화되어 선택할 수 없고Finish버튼도 작동하지 않는 현상 발생.
2. 원인 분석 (Cause)
원인 1: Windows 경로 길이 제한 (MAX_PATH)
- 폴더 깊이가 너무 깊으면 인덱싱 및 파일 접근 에러가 발생할 수 도 있음
원인 2: 이미 워크스페이스에 동일한 이름의 프로젝트가 존재
- 기존 워크스페이스에 동일한
artifactId를 가진 프로젝트가 이미 등록되어 있을 경우 중복 임포트가 차단됨.
원인 3: 이전 설정 파일과의 충돌
- 이전에 다른 IDE나 환경에서 생성된
.project,.settings등의 메타데이터가 현재 환경과 충돌할 수 있음.
3. 해결 방법 (Solution)
방법 1: 경로 단순화
- 프로젝트 폴더를 드라이브 루트에 가까운 경로로 이동시켜 경로 길이를 단축.
방법 2: 중복 프로젝트 확인 및 삭제
- Package Explorer에서 이름이 겹치는 프로젝트를 삭제(Delete)하여 충돌 제거
방법 3: .project 및 .settings 파일 정리
- 폴더 내의
.project,.classpath파일과.settings폴더를 삭제하여 설정 정보 초기화
4. 최종 해결 (Action Taken)
"경로 최적화 + 워크스페이스 신규 생성”
- 프로젝트 경로를 단순하게 변경함.
- test 라는 이름의 새로운 워크스페이스(Workspace)를 생성하여 기존의 꼬여있던 메타데이터 간섭을 완전히 차단
5. 회고 (Retrospective)
- 개발 환경에서 프로젝트 경로는 최대한 짧고 간결하게 관리하는 것이 예기치 못한 에러를 방지하는 지름길임을 깨달음
- 원인 파악이 힘들 때는 기존 설정을 고치려 하기보다, 새로운 워크스페이스를 생성하여 클린한 상태에서 재시작하는 것이 훨씬 효율적인 해결책이 될 수 있음을 배움
