명령 프롬프트에서 Java 경로가 인식되지 않는 문제를 해결하는 방법

안녕하세요, 동료 개발자 여러분! 😊 명령 프롬프트에 `java -version`을 입력했는데 "java가 내부 또는 외부 명령으로 인식되지 않습니다."라는 오류 메시지가 나타난 적 있으신가요? 이런 흔한 오류 때문에 개발 작업이 중단되는 경우가 종종 발생합니다. 하지만 걱정하지 마세요. 저희가 해결 방법을 알려드리겠습니다. 이 간결하고 실용적인 가이드에서는 Windows 환경에서 발생하는 "Java 경로 인식 오류"를 진단하고 해결하는 방법을 단계별로 안내해 드립니다. 이 가이드를 마치면 Java가 원활하게 실행되어 전문가처럼 앱을 컴파일하고 실행할 수 있게 될 것입니다. 자, 그럼 바로 코딩으로 돌아가 볼까요!

Java 경로를 인식할 수 없다는 오류가 발생하는 이유는 무엇인가요? 🔍

이 문제의 근본 원인은 대개 환경 변수에 있습니다. Java를 설치할 때(예: Oracle의 최신 JDK 또는 OpenJDK) Java 바이너리가 시스템의 PATH에 자동으로 추가되지 않는 경우가 있습니다. 이 때문에 명령 프롬프트에서 java.exe 또는 기타 도구를 찾을 수 없게 됩니다.

일반적인 원인으로는 다음과 같은 것들이 있습니다:

  • ❌ 설치가 불완전하거나 여러 Java 버전이 충돌합니다.
  • ❌ JAVA_HOME 및 PATH 설정이 누락되었거나 잘못되었습니다 .
  • ❌ 사용자 환경 변수와 시스템 환경 변수가 동기화되지 않았습니다.

이 점을 이해하면 문제를 빠르게 해결할 수 있습니다. 잠시만 기다려 주세요. 다음 단계는 간단하며 최신 Windows 빌드에서 테스트를 거쳤습니다.

1단계: 자바 설치를 확인하세요 🛠️

경로를 수정하기 전에 Java가 실제로 설치되어 있는지 확인하십시오. 명령 프롬프트(시작 메뉴에서 "cmd"를 검색)를 열고 다음을 입력하십시오.

java -version

버전 정보(예: "Java 버전 21.0.1")가 표시되면 좋습니다! 하지만 오류가 표시되면 다음 단계로 진행하세요. 다음으로 Java가 기본 위치에 있는지 확인하십시오.

  • C:\Program Files\Java (또는 32비트 시스템의 경우 C:\Program Files (x86)\Java ) 경로로 이동하십시오 .
  • jdk-21 또는 이와 유사한 폴더를 찾아보세요 (사용 중인 버전에 맞게 조정하세요).

JDK가 설치되어 있지 않다면 신뢰할 수 있는 출처에서 최신 JDK를 다운로드하여 설치하세요. 최신 빌드는 Oracle의 Java 다운로드 페이지 또는 OpenJDK용 Eclipse Adoptium 에서 확인할 수 있습니다 . 기본 옵션으로 설치하되, 설치 경로를 기록해 두세요. 나중에 필요합니다.

Windows의 Java 설치 디렉터리

꿀팁: 설치 중에 "PATH에 추가" 옵션이 있으면 체크하세요. 시간을 절약할 수 있습니다!

2단계: JAVA_HOME 환경 변수를 설정하세요 🏠

JAVA_HOME은 Java 설치 루트를 가리킵니다. Maven이나 Gradle 같은 도구를 사용하려면 필수적입니다. 설정 방법은 다음과 같습니다.

  1. 바탕 화면이나 파일 탐색기에서 "이 PC"(또는 "컴퓨터")를 마우스 오른쪽 버튼으로 클릭한 다음 속성을 선택합니다 .
  2. 왼쪽의 고급 시스템 설정을 클릭하세요 .
  3. 시스템 속성 창에서 환경 변수를 클릭합니다 .
  4. "시스템 변수"(하단 섹션)에서 새로 만들기를 클릭합니다 .
  5. 변수 이름: JAVA_HOME
    변수 값: JDK 설치 경로 (예: C:\Program Files\Java\jdk-21 ). (끝에 슬래시(/)를 붙이지 마세요!)
  6. 저장하려면 확인을 클릭하세요.

왜 이것이 중요할까요? 많은 앱이 Java 도구를 찾기 위해 JAVA_HOME 환경에 의존하기 때문입니다. JAVA_HOME을 올바르게 설정하면 향후 발생할 수 있는 문제를 예방할 수 있습니다.

3단계: PATH 환경 변수를 업데이트하세요 📁

이제 명령 프롬프트가 실행 파일을 찾을 수 있도록 Java의 bin 폴더를 PATH에 추가하세요. 환경 변수 창에서 계속 진행하세요.

  1. "시스템 변수"에서 Path를 찾아 선택한 다음 편집을 클릭합니다 .
  2. [새로 만들기]를 클릭 하고 다음을 추가하세요: %JAVA_HOME%\bin (이렇게 하면 JAVA_HOME이 자동으로 사용됩니다).
  3. Java 버전이 여러 개 있는 경우 최신 버전이 맨 위에 있는지 확인하거나 C:\Program Files\Java\jdk-21\bin 과 같이 버전별 경로를 사용하십시오 .
  4. 변경 사항을 적용하려면 모든 창에서 확인을 클릭하십시오.

변경 사항을 적용하려면 명령 프롬프트를 닫았다가 다시 여세요. 그런 다음 `java -version` 명령을 다시 실행하여 테스트하세요. 성공했나요? 🎉 다음과 같은 출력이 표시될 것입니다.

openjdk version "21.0.1" 2023-10-17
OpenJDK Runtime Environment (build 21.0.1+12-29)
OpenJDK 64-Bit Server VM (build 21.0.1+12-29, mixed mode, sharing)
Windows에서 PATH 환경 변수 편집하기

그래도 문제가 해결되지 않으면 오타가 없는지 다시 한번 확인하세요. 일부 상황에서는 경로가 대소문자를 구분합니다.

흔히 발생하는 문제점과 빠른 해결책 ⚠️

모든 절차를 완벽하게 따르더라도 문제가 발생할 수 있습니다. 자주 발생하는 오류와 해결책을 정리한 표를 참고하세요.

  • 두 설정을 모두 지정하거나 "관리자 권한으로 실행"을 사용하여 시스템 전체에 적용하세요.
  • 오류 메시지 가능한 원인 고치다
    'java'가 인식되지 않습니다. PATH가 업데이트되지 않았거나 잘못되었습니다. %JAVA_HOME%\bin을 PATH 환경 변수에 다시 추가하고 CMD를 재시작하세요.
    JAVA_HOME이 잘못 설정되었습니다. 잘못된 디렉토리 경로입니다 경로가 JRE가 아닌 JDK 루트를 가리키는지 확인하십시오. 예: jdk-21 폴더
    여러 Java 버전이 충돌합니다. PATH의 이전 항목 PATH 환경 변수를 수정하여 최신 버전을 우선적으로 설치하고, 가능하다면 이전 버전을 제거하세요.
    한 명령 프롬프트에서는 작동하지만 다른 명령 프롬프트에서는 작동하지 않습니다. 사용자 변수 vs. 시스템 변수

    32비트와 64비트 버전 불일치의 경우, Java 버전이 시스템 아키텍처와 일치하는지 확인하십시오( 시스템 속성 > 정보 에서 확인 가능 ).

    명령 프롬프트에서 Java 버전 확인이 성공적으로 완료되었습니다.

    완벽한 자바 설정을 위한 고급 팁 💡

    문제가 해결되면 설정을 업그레이드하세요.

    • ⭐ 간편한 관리를 위해 Chocolatey 또는 Winget을 사용하세요 : 관리자 권한으로 실행 winget install EclipseAdoptium.Temurin.21.JDK한 명령 프롬프트에서 설치하세요.
    • 🔧 개발자의 경우 IntelliJ 또는 VS Code와 같은 IDE와 통합하세요. 이러한 IDE는 종종 JAVA_HOME을 자동으로 감지합니다.
    • 📱 Windows 11을 사용 중이라면, 설정 앱의 시스템 > 정보 > 고급 시스템 설정에서 간소화된 환경 변수 편집기를 사용할 수 있습니다.
    • 🧪 철저한 테스트: `javac -version` (컴파일러 버전 확인) 및 `java -jar somefile.jar` 명령어를 실행하여 모든 기능이 정상적으로 작동하는지 확인하십시오.

    이러한 조정은 당면한 문제를 해결할 뿐만 아니라 진행 중인 프로젝트를 위한 환경을 더욱 안정적으로 만들어 줍니다.

    마무리: 자바 경로 문제 해결, 코딩 시작! 🚀

    축하합니다! 명령 프롬프트에서 Java 경로가 인식되지 않는 문제를 해결하셨습니다 ! JAVA_HOME과 PATH 환경 변수가 올바르게 설정되었으니 이제 최신 Windows 버전에서 원활한 Java 개발을 시작할 수 있습니다. 혹시라도 문제가 발생하면 아래에 댓글을 남겨주세요. 여러분의 성공 사례를 듣는 것을 언제나 환영합니다! 자, 이제 커피를 한 잔 마시거나 (혹은 Java 앱을 실행하거나) 계속해서 개발을 이어가세요. 즐거운 코딩 되세요! 👏

    최신 Java 릴리스를 유지하면 보안과 성능을 보장할 수 있다는 점을 기억하세요. 공식 소스를 정기적으로 확인하여 패치를 확인하십시오.

    댓글 남기기

    Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

    Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

    Nextcloud 업로드 설정, iOS 권한, 배터리 모드 및 iPhone 백그라운드 예약 기능의 제한 사항을 확인하여 백그라운드 사진 감지 기능을 복원하세요.

    ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

    ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

    ONLYOFFICE의 글꼴 힌팅 모드를 비교하고, 확대/축소 및 Linux 글꼴 사용 가능 여부를 확인하고, 흐림 효과가 편집기에만 적용되는지 아니면 데스크톱 전체에 영향을 미치는지 검증하십시오.

    ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

    ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

    ONLYOFFICE 데스크톱 편집기에서 PDF를 로컬로 변환한 다음 DOCX 파일을 검토하여 레이아웃 변경 사항, 스캔한 페이지 및 수정이 필요한 텍스트를 확인하십시오.

    ONLYOFFICE 데스크톱 편집기를 ownCloud 파일에 연결하세요

    ONLYOFFICE 데스크톱 편집기에 ownCloud 계정을 추가하고, 연결을 통해 얻을 수 있는 이점을 이해한 다음, 직접 액세스, 동기화 및 브라우저 편집 중에서 선택하세요.

    ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

    ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

    올바른 포털 또는 WebDAV 주소를 사용하고, 휴대폰에서 HTTPS 연결 가능 여부를 테스트하고, 사설 네트워크, TLS 및 로그인 문제를 구분하십시오.

    ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

    ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

    ONLYOFFICE 데스크톱 편집기용 사용자 지정 플러그인을 빌드하고 테스트한 다음, 해당 .plugin 아카이브를 설치하고 디버깅을 위해 개발자 도구를 활성화합니다.

    LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

    LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

    Calc에서 Python 함수를 사용할 수 있도록 만들고, 열려 있는 스프레드시트에서 해당 함수를 실행하고, LibreOffice와 시스템 Python을 혼동하지 않고 누락된 매크로 또는 가져오기 문제를 해결하세요.

    선택한 작성자 텍스트를 섹션 암호로 보호하세요

    선택한 작성자 텍스트를 섹션 암호로 보호하세요

    Writer 문서의 나머지 부분은 계속 사용할 수 있도록 유지하면서 특정 구절에 대한 일반적인 편집을 차단하는 방법과 파일 암호화가 더 나은 선택인 경우를 알아보세요.

    LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

    LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

    Calc에서 테마, 셀 글꼴 색상, 채우기 및 조건부 서식을 확인하여 잘 보이지 않는 스프레드시트 텍스트를 수정하세요.

    LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

    LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

    Calc에서 계산된 값 대신 수식 텍스트가 표시되는 이유를 알아보고, 표시 모드, 텍스트 서식 셀, 작은따옴표 또는 오래된 결과 문제를 해결하세요.