KoNLPy No JVM shared library file jvm.dll 오류 해결: JAVA_HOME 설정 가이드

Python에서 KoNLPy나 WordCloud 관련 코드를 실행할 때 No JVM shared library file (jvm.dll) found 오류가 발생한다면 대부분 Java 설치 경로 또는 JAVA_HOME 환경 변수 문제입니다.

오류 메시지

No JVM shared library file (jvm.dll) found. Try setting up the JAVA_HOME environment variable properly.

원인

  • Java가 설치되어 있지 않습니다.
  • JAVA_HOME 환경 변수가 JDK 설치 폴더를 가리키지 않습니다.
  • Path에 Java 실행 경로가 등록되어 있지 않습니다.
  • Python/Java가 32비트와 64비트로 서로 맞지 않습니다.

Step 1. Java 설치 확인

java -version

버전이 출력되지 않으면 JDK를 먼저 설치해야 합니다. KoNLPy를 안정적으로 쓰려면 JRE보다 JDK 설치를 권장합니다.

Step 2. JAVA_HOME 설정

Windows 환경 변수에서 JAVA_HOME을 새로 만들고 JDK 설치 폴더를 지정합니다. 예시는 다음과 같습니다.

JAVA_HOME=C:Program FilesJavajdk-17

Step 3. Path에 Java bin 추가

%JAVA_HOME%bin

Step 4. 터미널 재시작 후 확인

echo %JAVA_HOME%
java -version

KoNLPy 실행 확인

python -c "from konlpy.tag import Okt; print(Okt().morphs('테스트 문장입니다'))"

FAQ

JRE만 설치해도 되나요?

환경에 따라 가능할 수 있지만, 오류를 줄이려면 JDK 설치를 권장합니다.

JAVA_HOME은 bin 폴더까지 써야 하나요?

아닙니다. JAVA_HOME은 JDK 루트 폴더를 가리키고, Path%JAVA_HOME%bin을 추가하는 방식이 일반적입니다.