🐞 Eclipse에서 Maven Project 생성 시 maven-resources-plugin:2.6 오류 해결 방법

Eclipse에서 Maven 프로젝트 생성 시 발생할 수 있는 maven-resources-plugin:2.6 관련 오류를 해결하는 방법을 안내합니다. 해당 오류는 주로 Maven이 중앙 저장소로부터 필요한 정보를 제대로 가져오지 못할 때 발생합니다.

⚠️ 발생 오류 예시

Maven 프로젝트 생성 도중 다음과 같은 오류 메시지를 볼 수 있습니다:

could not calculate build plan
maven-resources-plugin:2.6

이 오류는 Maven이 특정 플러그인 정보를 가져오는 데 실패할 경우 발생합니다. 특히 인터넷 환경이 제한적이거나, 사내 방화벽, 또는 저장소 설정이 잘못된 경우에 자주 나타납니다.

🔧 해결 방법: `settings.xml` 수정

Maven의 설정 파일인 settings.xml을 수정하여 Maven이 접근 가능한 미러 저장소를 사용하도록 지정하면 문제를 해결할 수 있습니다.

✅ 수정 예시

아래와 같이 settings.xml 파일을 작성하거나 수정해 주세요:

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" 
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 
                              http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <mirrors>
    <mirror>
      <id>UK</id>
      <name>UK Central</name>
      <url>http://uk.maven.org/maven2</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

</settings>

🔁 위 설정은 Maven이 http://uk.maven.org/maven2 저장소를 중앙 저장소(central)의 대체 미러로 사용하도록 지정합니다.

📁 settings.xml 위치

settings.xml 파일은 다음 위치 중 하나에 존재해야 합니다:

${MAVEN_HOME}/conf/settings.xml (Maven 설치 디렉토리)
${USER_HOME}/.m2/settings.xml (사용자 홈 디렉토리)

📝 일반적으로 사용자 디렉토리의 .m2 폴더에 존재하는 settings.xml을 수정하는 것이 가장 안전하고 권장됩니다.

🔎 추가 팁

설정을 바꾼 후 Eclipse에서 프로젝트 > Maven > Update Project (Alt + F5)를 눌러 다시 빌드해 보세요.
내부망 환경에서는 기업 전용 Nexus 또는 Artifactory 저장소를 설정해 두는 것도 좋은 방법입니다.
maven-resources-plugin 버전을 명시적으로 설정하는 것도 오류 방지에 도움이 됩니다.

📚 마무리

Eclipse에서 Maven 프로젝트 생성 시 maven-resources-plugin:2.6 오류가 발생하면, 대부분은 저장소 접근 문제이므로 settings.xml 파일을 수정해 미러 서버를 지정하는 방식으로 해결할 수 있습니다.

📌 위 방법으로도 해결되지 않는 경우, Maven 로그의 디테일한 에러 메시지를 분석해보거나 네트워크 방화벽 정책을 확인해보는 것이 좋습니다. 문제를 빠르게 해결하시길 바랍니다 😊