본문 바로가기
Text Mining

(Text Mining 01편) JAVA, Jpype1, KoNLPy 설치하기

by mangoseed3434 2026. 1. 10.

안녕하세요. mangoseed3434입니다.

 

이번 포스팅에서는 Python으로 한국어 텍스트 마이닝을 할 수 있는 환경 설정 과정을 정리합니다.

 

사실 그동안 JVMNotFoundException 오류로 텍스트 마이닝을 못하고 있어서 골머리를 앓았습니다.

 

JVMNotFoundException 오류

 

JVMNotFoundException: No JVM shared library file (jv.dll) found.

Try Setting up the JAVA_HOME environment variable properly.

 

이 오류는 Java, JPype1, KoNLPy 간의 환경 설정이 올바르지 않을 때 자주 발생합니다.
해당 오류가 발생하지 않고 정상적으로 텍스트 마이닝을 수행할 수 있도록 환경 설정 전 과정을 단계별로 정리했습니다.

 


 

전체 진행 단계

 

환경 설정은 다음 6단계로 구성됩니다.

0단계 : 기존 JAVA_HOME, JPype1, KoNLPy 삭제

1단계 : 신규 JAVA_HOME 설정

2단계 : JPype1 라이브러리 설치

3단계 : KoNLPy 라이브러리 설치

4단계 : 컴퓨터 재부팅

5단계 : 텍스트 마이닝 실행 확인

 

기존에 Java, JPype1, KoNLPy를 설치한 적이 없다면 1단계부터 진행하면 됩니다.


 

0단계 : 기존 JAVA_HOME, JPype1, KoNLPy 삭제

 

 

① 기존 JAVA_HOME 환경 변수 삭제

 

시작 → 설정    설정 검색창 → '시스템 환경 변수 편집' 입력

 

고급 tab → 환경 변수

 

시스템 변수 영역에서 JAVA_HOME 선택 → 삭제 → 확인

 


 

② 기존 Java JDK 삭제

 

 

설정 → 앱 및 기능 → Java(TM) SE Development Kit 선택 → 제거

 


 

③ 기존 JPype1 라이브러리 삭제

 

cmd → pip uninstall jpype1 입력 및 엔터

 

Y 입력 및 엔터

 


 

④ 기존 KoNLPy 라이브러리 삭제

 

pip uninstall konlpy 입력 및 실행

 

Y 입력 및 엔터

 


 

1단계 : 신규 JAVA_HOME 설정

 

① 컴퓨터 Bit 확인

 

 

Bit는 cmd로 확인할 수 있습니다.

cmd → systeminfo 입력 및 실행

 

systeminfo 출력 결과 중 시스템 종류 항목을 확인합니다.
예를 들어 x64-based PC라면 64비트 운영체제입니다.

 


 

② Java 설치 파일 다운로드

 

제 컴퓨터의 운영체제는 window이고 64비트입니다.

위 조건에 맞는 Java 설치 파일을 Oracle 공식 홈페이지에서 다운로드합니다.

 

Java Downloads | Oracle 대한민국

 

Download the Latest Java LTS Free

Subscribe to Java SE and get the most comprehensive Java support available, with 24/7 global access to the experts.

www.oracle.com

 

JAVA Oracle 홈페이지에서 본인의 컴퓨터 운영체제, Bit에 맞춰 설치파일을 다운로드하고 실행합니다.

 

설치 파일 실행 → Next 클릭

 

Change 클릭

 

Java 설치 경로를 복사해 메모장 등에 저장

그리고 Cancel 클릭

 

Next 클릭

 

 

 

Close 클릭

 


 

③ JAVA_HOME 환경 변수 생성

 

시작 → 설정    설정 검색창 → '시스템 환경 변수 편집' 입력

 

고급 tab → 환경 변수 클릭

 

시스템 변수 → 새로 만들기 클릭

 

 

 

변수 이름: JAVA_HOME

변수 값: 앞서 저장한 Java 설치 경로

 

 

그리고 확인 클릭

 

시스템 변수에 JAVA_HOME이 생성된 것을 볼 수있습니다.

 

그리고 확인 클릭

 

확인 클릭


 

2단계 : JPype1 라이브러리 설치

 

① Python 버전 확인

 

자신의 Python 버전에 맞는 Jpype1 라이브러리를 설치해야 텍스트 마이닝을 할 수 있습니다.

Python버전은 cmd에서 확인할 수 있습니다.

 

cmd → python 입력 및 실행

 

빨간색으로 표시한 부분이 python의 버전입니다.

 

제가 사용하는 컴퓨터의 python 버전은 3.11이네요.

 


 

② Python 버전에 맞는 JPype1 다운로드

 

Jpype1 공식 홈페이지에서  python 버전에 맞는 Jpype1을 설치합니다.

jpype1 · PyPI

 

jpype1

A Python to Java bridge

pypi.org

 

 

사이트 좌측의 '파일 다운로드' 클릭

 

 

스크롤을 내려보면, 각 운영체제와 파이썬 버전에 따른 Jpype1 라이브러리 파일을 다운받을 수 있습니다.

 

 

window 운영체제외 python 3.11버전의 Jpype1 라이브러리도 찾을 수 있었습니다.

 


 

③ JPype1 설치

 

다운로드한 JPype1 파일 선택 → F2

 

Ctrl+A를 먼저 누르고 Ctrl+C를 눌러, 파일명+확장자명을 모두 복사합니다.

 

그리고 경로창을 바로 선택합니다.

 

경로창에 cmd를 입력하고 실행합니다.

 

그러면 바로 cmd가 실행되는데,

C:\Users\사용자명\Downloads인 것을 볼 수 있습니다.

 

pip install을 입력하고 Ctrl+V를 눌러 다운로드한 Jpype1 파일명과 확장자를 붙여넣기하고 실행합니다.

(pip install JPype1-파일명.whl 입력 및 실행)

 

본인 컴퓨터의 운영체제와 Python 버전에 맞는 Jpype1 라이브러리가 설치되었습니다.


 

3단계 : KoNLPy 라이브러리 설치

 

cmd에 pip install konlpy를 입력하고 실행합니다

 

 

이제 한국어 텍스트 마이닝을 위한 기본 환경 설정이 완료되었습니다!!!


 

 

4단계 : 컴퓨터 재부팅

 

컴퓨터를 재부팅합니다.

JVMNotFoundException 오류가 발생하지 않기를 기도합니다.

 


 

 

5단계 : 텍스트 마이닝 실행 확인

 

KoNLPy가 정상적으로 설치되었는지 확인하기 위해 형태소 분석을 실행합니다.
포스팅에서는 Jupyter Notebook 환경에서 테스트하겠습니다.

 

KoNLPy 라이브러리에서 제공하는 형태소 분석기 중 Okt 클래스를 사용합니다.

Twitter 클래스의 이름은 영어 알파벳 대문자 O의 Okt입니다.

 

 

 

 

가수 송소희님이 노래 '천몽지로'의 가사를 예시 텍스트로 사용했습니다.

 

 

형태소 분석기 클래스에서 공통으로 지원하는 3개의 함수를 적용해보았습니다.

 

형태소 분석기에서 공통으로 제공하는 3개의 함수들을 적용한 결과입니다.

다행히 에러 없이 텍스트 마이닝이 정상적으로 수행됨을 확인할 수 있었습니다.

 


 

JVMNotFoundException 오류를 어려움을 겪는 분들께 도움이 되기를 바랍니다.
읽어주셔서 감사합니다.