이클립스(Eclipse)는 자바(Java) 플러그인 시스템을 기반으로 하는 오픈소스 개발 도구로, 서로 다른 프로그래밍 언어를 사용하는 개발자들이 하나의 환경에서 손쉽게 작업할 수 있도록 지원합니다. 다양한 운영체제를 지원하며, 그중에서도 Windows 환경에서 널리 활용되고 있습니다. 이 글에서 다루는 오류는 사용자가 Windows PC에서 이클립스를 실행하려고 할 때 나타나는 문제입니다.
이 오류가 발생하면 이클립스는 대부분 곧바로 종료됩니다. 문제는 주로 이클립스를 설치하고 처음 실행하는 시점에 나타나며, 온라인에서 다양한 해결 방법이 공유되어 왔습니다. 이 글에서는 검증된 해결 방법들을 한곳에 모아 정리했습니다.
'JNI 공유 라이브러리 로드 실패' 오류의 원인
이 문제는 오류를 보고한 수많은 사용자들 사이에서 공통적으로 나타나는 한두 가지 원인 때문에 발생하는 경우가 많습니다. 다만 해결 방법은 여러 가지가 있으니, 아래 목록을 확인해 보세요.
- 이클립스와 Java Runtime 버전 불일치 – 두 프로그램은 반드시 모두 64비트이거나 모두 32비트여야 합니다. 비트가 맞지 않으면 이 오류가 반드시 발생하므로, 두 프로그램을 동일한 비트 버전으로 맞춰야 합니다.
- 32비트와 64비트 Java가 모두 설치된 경우 – 이클립스가 잘못된 버전에 접근할 수 있습니다. Path 환경 변수를 수정해 올바른 버전을 가리키도록 설정해야 합니다.
- 이클립스가 Java 설치 폴더를 인식하지 못하는 경우 – eclipse.ini 파일에 해당 경로를 명시해 혼란을 해소해야 합니다.
방법 1: 'eclipse.ini' 파일 수정
이 문제는 이클립스가 실행 파일의 올바른 경로를 제대로 찾지 못할 때 발생할 수 있습니다. 설치 폴더에 있는 이클립스 구성 파일에 몇 줄을 추가하는 것만으로 간단히 해결할 수 있습니다. 아래 지침을 순서대로 따라 해 보세요.
- 파일 탐색기를 열어 폴더 위치로 이동합니다. 왼쪽 탐색 창에서 내 PC(This PC) 또는 내 컴퓨터(My Computer)를 클릭하거나, 시작 메뉴에서 해당 항목을 검색해 열 수 있습니다.
- 내 PC에서 로컬 디스크(C:)를 더블클릭해 열고 JDK(Java Development Kit) 설치 디렉터리로 이동합니다. Java 폴더를 찾았다면 jrex.x.xx > bin 순서로 들어가 'javaw.exe' 파일을 찾습니다. 주소창을 클릭해 전체 경로를 복사해 둡니다. 'x.x.xx'는 설치된 Java 버전을 나타냅니다.
- 이클립스 설치 폴더로 이동합니다. 이클립스 바로 가기를 마우스 오른쪽 버튼으로 클릭하고 파일 위치 열기를 선택하면 정확한 위치를 쉽게 찾을 수 있습니다.
- 'eclipse.ini' 파일을 마우스 오른쪽 버튼으로 클릭하고 메모장으로 엽니다. 파일 최상단으로 이동한 후 아래 두 줄을 붙여넣습니다. 이때 예시 경로는 앞서 복사한 실제 javaw.exe 경로로 반드시 교체해야 합니다.
-vm C:\path\to\64bit\java\bin\javaw.exe
- 프로그램을 다시 실행해 'JNI 공유 라이브러리 로드 실패' 오류가 여전히 나타나는지 확인합니다.
방법 2: 이클립스와 Java 버전 일치시키기
64비트 버전의 이클립스를 사용 중이라면 64비트 버전의 Java Runtime도 설치되어 있어야 하며, 32비트 버전도 마찬가지입니다. 아래 지침에 따라 기존 Java를 제거한 뒤 올바른 버전을 새로 설치하세요.
Windows 10에서 Java 제거하기
- 화면 왼쪽 하단의 시작 메뉴 버튼을 클릭합니다. 시작 메뉴에서 전원 버튼 위의 톱니바퀴 아이콘을 눌러 설정(Settings)을 엽니다.
- 설정 앱에서 앱(Apps) 섹션을 선택합니다. 설치된 앱 목록에서 Java를 찾아 클릭한 뒤 제거(Uninstall) 버튼을 누릅니다.
- 화면에 표시되는 안내에 따라 제거 과정을 완료합니다.
이전 버전 Windows에서 Java 제거하기
- 화면 왼쪽 하단의 시작 메뉴 버튼을 클릭합니다.
- 시작 메뉴에서 제어판(Control Panel)을 선택하고, '보기 기준' 옵션을 범주(Category)로 변경합니다. 프로그램 섹션 아래의 프로그램 제거를 클릭합니다.
- 설치된 프로그램 목록에서 Java를 클릭해 선택한 뒤 제거 버튼을 누릅니다. 화면 안내에 따라 마법사를 완료합니다.
Java 설치하기
Java를 설치하는 방법은 두 가지입니다. 전체 프로그램을 내려받는 데 사용되는 작은 파일만 먼저 받는 온라인 설치 방식과, 전체 패키지를 미리 받아 인터넷 연결 없이 설치하는 오프라인 방식이 있습니다. 여기서는 오프라인 설치 방법을 소개합니다.
- Oracle의 수동 다운로드 페이지로 이동해 Windows Offline을 클릭합니다. 이때 32비트 버전인 Windows Offline과 64비트 버전인 Windows Offline (64-bit)을 반드시 구분해서 선택해야 합니다.
- 파일 다운로드 대화 상자가 나타나며 실행 또는 저장 여부를 묻습니다. 저장(Save)을 클릭해 로컬 시스템에 파일을 내려받습니다.
- 브라우저를 포함한 모든 응용 프로그램을 닫고, 저장한 파일을 더블클릭해 설치를 시작합니다. 설치(Install) 버튼을 클릭해 라이선스 조건에 동의하고 설치를 계속 진행합니다.
- Oracle은 다양한 제품을 제공하는 회사들과 제휴하고 있어, Java 설치 과정에서 해당 프로그램들을 함께 설치할지 묻는 화면이 나타날 수 있습니다. 원하지 않는 항목의 선택을 해제한 뒤 다음(Next) 버튼을 클릭해 설치를 계속합니다.
- 몇 개의 짧은 대화 상자가 설치 마지막 단계를 안내합니다. 마지막 대화 상자에서 닫기(Close)를 클릭하면 Java 설치가 완료됩니다. 이클립스와 Java Runtime의 버전을 일치시킨 후에도 문제가 발생하는지 확인해 보세요.
방법 3: Java의 Path 환경 변수 제거하기
컴퓨터에 32비트와 64비트 Java가 모두 설치되어 있다면, 이클립스가 어느 쪽을 사용해야 할지 혼동할 수 있습니다. 예를 들어 64비트 이클립스가 32비트 Java를 사용하려고 하면 문제가 발생합니다. 이 경우 Java를 제거하지 않고도 해당 버전의 Path 변수를 삭제하는 것만으로 문제를 해결할 수 있습니다. 아래 지침을 신중하게 따르세요.
- 운영체제 버전에 따라 내 컴퓨터/내 PC를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties)을 선택합니다. 속성 창 오른쪽에서 고급 시스템 설정 버튼을 찾아 클릭한 뒤 고급(Advanced) 탭으로 이동합니다.
- 고급 탭 하단 오른쪽에서 환경 변수(Environment Variables) 옵션을 클릭합니다. 그러면 '사용자 변수' 섹션 아래에 모든 사용자 변수 목록이 표시됩니다.
- 시스템 변수 또는 사용자 변수 섹션에서 Path 변수를 클릭하고 아래의 편집(Edit) 버튼을 누릅니다. Java 폴더 경로를 찾아 선택한 뒤 왼쪽 메뉴에서 삭제(Delete)를 선택합니다. 이때 삭제할 경로는 이클립스 버전과 일치하지 않는 Java 폴더입니다.
- 프로그램을 다시 열어 정상적으로 실행되는지 확인합니다.
대부분의 경우 첫 번째 또는 두 번째 방법만으로 문제가 해결됩니다. 그래도 오류가 계속된다면 세 번째 방법인 Path 변수 정리까지 시도해 보세요. 평소에 이클립스와 Java의 비트 버전을 항상 일치시켜 사용하면 이러한 오류를 미리 예방할 수 있습니다.