[이클립스] The Eclipse executable launcher was unable to locate i ts companion share

⚠️문제

Eclipse 바로가기 버튼 클릭시 Launcher 실행이 되지 않음.
 
에러 메세지    

The Eclipse executable launcher was unable to locate i ts companion shared liabray.

 
필자는 해당 문제를 두 번 겪었는데, 첫 번째 해결 방법대로 해보았으나 이번에는 해결이 되지 않아서 다른 방법으로 해결해 주었습니다. 저번에는 `eclipse.ini` 파일의 `-vm` 경로 (jvm경로) 가 잘못 지정되어 해당 부분만을 수정해 주니 단순히 해결이 되었습니다. 
 
이 문제가 일어나는 이유는 크게 두 가지 입니다.
 
1. 단순히 eclipse.ini 에서 경로가 잘못되었음. (필자의 경우 첫번째 에러는 이게 원인) 
2. 실행파일 자체가 삭제되거나 손상되었음. (두 번재 에러)
 
어떤 경우에 해당하는지 테스트 해 보는 방법은 간단합니다.
만약 첫번째 원인 때문이라면 이클립스 바로가기 아이콘을 누르면 실행이 안 되지만, 이클립스가 설치된 폴더로 가서 luancher.jar 파일을 더블클릭해서 실행해 보시면 실행이 잘 될 것입니다. 이 경우 실행에 필요한 파일들에는 문제가 없고 경로 지정 문제입니다.
 
jar파일 위치는
`eclipse.ini`를 메모장으로 열었을 때 `-startup` 이라고 된 부분 아래 있습니다.

-startup
plugins/org.eclipse.equinox.launcher_1.6.900.v20240613-2009.jar

 
저 같은 경우 아래 경로에 있었습니다.

C:\Users\aweso\eclipse\jee-2024-09\eclipse\plugins

 
이 jar파일을 더블클릭해 열어 보았는데 아래 화면처럼 실행이 잘 된다면 이 경우에는 단순히 `eclipse.ini` 경로가 잘못 지정된겁니다.
 

 

✅ 해결법1. eclipse.ini 파일 경로 지정 문제

 
`eclipse.ini`를 열어서 아래 세 가지 경로를 체크 해 주시고 수정해주세요.
 
`-startup` (이클립스 launcher jar파일) 
`--launcher.library` (이클립스 실행에 필요한 라이브러리)
`-vm 경로` (JDK bin 폴더)

 
관련 포스팅

[이클립스] The Eclipse executable launcher was unable to locate i ts companion shared liabray. 에러 해결법

 
 
하지만 이렇게 했는데도 실행이 안 된다면 실행파일이 손상된 경우로 이클립스를 재설치 해야 합니다. 그렇다고 설정해 놓은 것이 다 날아가는 건 아니니까 안심하세요.
 
필자는 launcher 파일을 더블클릭 했는데도 이클립스가 열리지 않았는데, 그 이유는 실행파일이 있어야 할 위치인 `--lancher.library`에 아무 것도 없었기 때문입니다. 아래는 제 이클립스 라이브러리 위치입니다. 이 폴더에 들어가 보니 실행 파일은 없고 빈 껍데기인 `META-INF`만 하나 남아 있었습니다. 

 C:\Users\aweso\.p2\pool\plugins\org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.1100.v20240722-2106

 
이 폴더에는 Eclipse 런처가 실행되는 데 필요한 네이티브 라이브러리 파일(.dll, .so, 또는 .dylib)이 있어야 합니다. 하지만 경로에 이런 파일이 없으면 Eclipse는 필요한 리소스를 찾을 수 없어서 실행되지 않습니다. 

 
실행 파일이 손상된 경우에는 이클립스를 재설치해 주어야 하는데, 저도 설치전에는 라이브러리, 인코딩 설정, 환경변수 설정 등을 다시 해야 할 줄 알고 많이 망설였습니다.
 
그래서 저는  바탕화면에 새로운 폴더를 만들어서 재설치한 후, 동일한 런처 파일을 복사해서 기존에 있던 폴더에 붙여 넣으려고 했습니다. 하지만 제가 직접 해보니까 그렇게 하지 않아도 재설치를 하자 마자 기존 폴더에 귀신같이 원래 있던 설정파일들이 모두 스스로 복구가 되었습니다.
 

✅ 해결법2. 실행파일이 손상된 경우

 
이클립스를 재설치 해 봅시다.
설치 프로그램을 실행합니다.
 

 
이 때 경로는 기존 폴더로 지정 하지 마시고 바탕화면에 새 폴더를 만들어서 해 주세요!
저는 `etest`라는 폴더를 만들어서 여기에 이클립스를 설치해 주었습니다.
 

 
다 설치된 걸 확인하셨으면 이클립스를 열어 보세요. 아마 잘 실행이 되실겁니다!
 

 
이렇게  새롭게 이클립스를  설치하기만 하면 별도로 손을 쓰지 않아도 기존에 있는 설치 폴더에 손상되었던 파일들이 다 복구가 됩니다. 경로는 새폴더로 지정했는데 어떻게 기존 경로에 있는 실행 파일까지 복구가 되는지 너무 신기했습니다. 
그리고 새로 설치한 폴더는 삭제 해 주세요!
 

---

🧐 근본원인

위의 방법으로 이클립스 실행은 다시 가능해졌지만, 해당 오류가 여러 번 반복적으로 발생한데에는 근본적인 문제가 있을거라고 생각했습니다. 근본 원인을 제거 하지 않으면 계속 이런 에러가 뜨고 귀찮은 일이 벌어지기 때문에 원인을 찾아서 해결 해 주어야 겠다고 생각했습니다. 
 
저 같은 경우 이클립스 실행이 안 되기 직전에 공통점이 있었습니다.
`VSCode`만 들어 갔다 나오면 동일한 증상이 계속 생기는 겁니다. 알고 보니 `VSCode`에서 `.git`이 연결된 경로에 이클립스 설치가 되어 있어서 그런 것이었습니다. 즉  git 루트 디렉터리에 이클립스 설치파일이 있는 경우입니다. 이건 깃 경로가 잘못 지정된 거라서 터미널로 가셔서 해당 루트 디렉토리에 설치된 `.git`파일을 삭제 해 주셔야 합니다.
 
삭제할 때는 깃 `clean`을 하시면 중요한 파일들이 손상될 수 있으니 아래 해결법을 따라 해 보세요~
 
https://awesomepossum.tistory.com/430

[깃/깃허브] VSCode Git 10k 없애기 ( the git repository at XX has too many changes )