[Eclipse/STS3] 복제한 Maven 기반 프로젝트 Import 오류 해결

✅ Eclipse(Spring Tool Suite 3)에서 복제한 Maven 프로젝트가 보이지 않을 때 – 원인과 올바른 Import 방법

📌 상황 개요

기존 프로젝트 student-app을 복제하여 student-app-mysql로 새 프로젝트를 만들고
Eclipse(STS)에서 다음 경로로 import를 시도했습니다:

File > Import > General > Import Projects from File System

하지만...

---

❗ 문제 발생

• Import Projects from File System에서 프로젝트가 탐색되고 Finish를 눌렀지만
• Package Explorer에 아무 프로젝트도 표시되지 않음
• Servers 항목만 있고, 프로젝트는 안 보임

---

🧠 문제 원인

원인	설명
.project 파일의 <name>이 기존과 동일	기존 프로젝트와 이름이 충돌되면 Eclipse가 import를 무시
Hide already open projects가 체크됨	실제로는 import되지 않음
Maven 기반인데 일반 import 방식을 사용함	pom.xml이 있어도 Java 프로젝트로만 인식됨
Java Nature 인식 불가	.classpath, .project는 존재해도 Maven 설정이 적용되지 않음

---

✅ 해결 방법 (올바른 Import 방식 사용)

🎯 Maven 기반 프로젝트인 경우

반드시 아래 방식으로 Import해야 Eclipse가 Maven으로 인식함

File > Import > Maven > Existing Maven Projects

• Root directory: C:\dev\workspace\student-app-mysql (복제한 폴더 경로)
• pom.xml 자동 탐색됨 → 체크
• Finish 클릭

→ 💡 이 방식은 pom.xml을 기준으로 Maven Nature가 자동 적용되며,
빌드 경로와 의존성, 프로젝트 설정이 모두 정상 적용됩니다.

---

💡 일반 Java 프로젝트인 경우 (Maven이 아니라면)

File > Import > General > Existing Projects into Workspace

• .project 파일이 필요 (내부에 <name>student-app-mysql</name> 등 고유 이름이 들어 있어야 함)
• Maven이 아닌 Java-only 프로젝트 구조일 때 사용

❗ 이 방법은 Maven 의존성을 인식하지 않기 때문에 pom.xml이 있어도 설정이 불완전하게 적용됩니다.

---

✅ 정리된 비교표

Import 방식	대상 프로젝트	성공 여부	설명
✅ Maven > Existing Maven Projects	Maven 프로젝트 (pom.xml 있음)	O	가장 안정적. Maven Nature 자동 적용
❌ General > Import Projects from File System	Maven 프로젝트	✖	.project만 기준이라 pom.xml 무시
✅ General > Existing Projects into Workspace	Java 프로젝트 (.project 있음)	O	Maven이 아닌 일반 Java 프로젝트용

---

🔧 추가 팁

.project 파일 이름 충돌 방지

<projectDescription>
    <name>student-app-mysql</name>  <!-- ✅ 복제한 이름과 일치하도록 수정 -->
</projectDescription>

Package Explorer에 안 보일 때

• [▽] > Filters and Customization… 에서 Closed Projects, Empty Packages 필터 해제
• Project > Open Project, Project > Clean 실행

---

✅ 최종 요약

• ✅ Maven 프로젝트는 반드시 Maven > Existing Maven Projects로 Import
• ❌ Import Projects from File System은 Maven 구조를 제대로 인식하지 못함
• 💡 .project 파일 이름도 반드시 고유하게 변경할 것
• ✅ Import 후에도 안 보이면 필터 해제, Open Project, Clean으로 마무리

---