Stable Diffusion 로컬 설치 중 'Python was not found' 오류 해결: 시스템 환경 변수 PATH 추가와 3.10.6 버전 고정 설치 가이드
Error Zero Lab
소프트웨어 에러 해결 & 오피스 가이드 | 전문가의 정확한 솔루션
Stable Diffusion 로컬 설치 중 'Python was not found' 오류 해결: 시스템 환경 변수 PATH 추가와 3.10.6 버전 고정 설치 가이드
Stable Diffusion(Automatic1111) 로컬 환경 구축 시 가장 빈번하게 발생하는 'Python was not found' 오류는 시스템이 Python 실행 파일(.exe)의 위치를 식별하지 못하거나, 윈도우 기본 설정이 마이크로소프트 스토어로 리다이렉션될 때 발생합니다. 2026년 현재, Stable Diffusion 생태계는 발전했으나 여전히 특정 버전(3.10.6)의 경로 설정이 안정적인 구동의 핵심입니다. IT 솔루션 아키텍트의 관점에서 이 문제를 완벽히 해결하는 가이드를 제시합니다.
1. 오류 현상 및 정밀 진단 (Diagnosis)
사용자가 webui-user.bat 실행 시, 터미널 창에 다음과 같은 메시지가 출력되며 중단됩니다.
bash Python was not found; run without arguments to install from the Microsoft Store... 'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다. 이 오류는 단순히 파이썬이 없는 것이 아니라, "Stable Diffusion이 호출하는 'python'이라는 명령어가 시스템 환경 변수(PATH)에 등록되지 않았음"을 의미합니다.
2. 주요 발생 원인 (Root Causes)
- PATH 환경 변수 누락: 파이썬 설치 단계에서 'Add Python to PATH' 옵션을 체크하지 않음.
- App Execution Aliases 간섭: 윈도우가 실제 설치된 파이썬 대신 마이크로소프트 스토어의 설치 가이드를 우선 실행함.
- 버전 불일치: 최신 버전(Python 3.12+) 설치 시 기존 라이브러리와의 호환성 문제로 경로 인식이 실패하거나 런타임 에러 발생.
3. 단계별 해결 솔루션 (Step-by-Step Solutions)
[방법 1] Python 3.10.6 클린 재설치 (가장 권장)
기존의 잘못된 설치를 제거하고 표준 환경을 구축하는 가장 확실한 방법입니다.
- 제어판 > 프로그램 제거에서 설치된 모든 Python 항목을 삭제합니다.
- 공식 파일 다운로드: Python 3.10.6 공식 페이지에서
Windows installer (64-bit)를 내려받습니다. - 설치 설정 (필수): 설치 창 하단의 [Add Python 3.10 to PATH] 체크박스를 반드시 선택합니다.
Install Now를 클릭하여 완료합니다.
⚠️ 주의: 'Add Python to PATH'를 누락하면 재설치 후에도 동일한 오류가 반복됩니다.
[방법 2] webui-user.bat 내 파이썬 경로 강제 할당
시스템 전역 설정을 건드리지 않고 Stable Diffusion에만 특정 파이썬 위치를 알려주는 방식입니다.
- 파이썬 설치 경로를 확인합니다. (기본값:
C:\Users\[사용자명]\AppData\Local\Programs\Python\Python310\python.exe)- Tip: CMD에서
where python을 입력하여 실제 경로를 복사하십시오.
- Tip: CMD에서
- Stable Diffusion 폴더 내
webui-user.bat파일을 우클릭하여 [편집]을 선택합니다. -
set PYTHON=항목을 찾아 아래와 같이 실제 경로를 입력합니다. ```batch set PYTHON="C:\Users\본인계정명\AppData\Local\Programs\Python\Python310\python.exe" -
저장 후 파일을 다시 실행합니다.
[방법 3] Windows 앱 실행 별칭(App Execution Aliases) 비활성화
파이썬 실행 시 자꾸 마이크로소프트 스토어가 열리는 현상을 원천 차단합니다.
- 윈도우 [설정] > [앱] > [고급 앱 설정] > [앱 실행 별칭]으로 이동합니다.
- 목록에서
python.exe및python3.exe항목을 찾아 모두 [끔(Off)]으로 변경합니다.
[방법 4] 시스템 환경 변수(PATH) 수동 등록
이미 3.10.6 버전이 설치되어 있다면 환경 변수만 수동으로 지정할 수 있습니다.
Win + R키를 누르고sysdm.cpl입력 후 엔터.- [고급] 탭 > [환경 변수] 클릭.
- '사용자 변수' 목록에서 Path 선택 후 [편집] 클릭.
- [새로 만들기]를 클릭하여 아래 두 경로를 추가합니다.
%USERPROFILE%\AppData\Local\Programs\Python\Python310%USERPROFILE%\AppData\Local\Programs\Python\Python310\Scripts
- 모든 창에서 '확인'을 누르고, 반드시 기존 CMD 창을 닫은 후 새로 열어 적용합니다.
4. 해결 여부 최종 검증 (Verification)
조치 후 새 명령 프롬프트(CMD)를 열고 아래 명령어를 입력하여 정상 작동 여부를 확인합니다.
bash
python --version
* 정상 출력: Python 3.10.6
* 비정상: 여전히 오류가 발생한다면 webui-user.bat 파일 내 set PYTHON= 뒤에 불필요한 공백이 있는지, 혹은 경로에 한글 사용자명이 포함되어 인식이 안 되는지 확인하십시오.
5. 해결 방법 비교 요약
| 해결 방법 | 권장 상황 | 난이도 | 성공 확률 |
|---|---|---|---|
| 방법 1 (재설치) | 입문자, 버전이 뒤섞인 경우 | 낮음 | 최상 |
| 방법 2 (Batch 수정) | 다중 Python 버전 사용자 | 낮음 | 매우 높음 |
| 방법 3 (별칭 비활성화) | 스토어 창이 자꾸 뜨는 경우 | 매우 낮음 | 필수 |
| 방법 4 (PATH 수동 등록) | 숙련자, 재설치를 원치 않을 때 | 중간 | 높음 |
전문가 제언: 2026년 기준, 윈도우 사용자 계정명이 '한글'로 되어 있을 경우 파이썬 환경 변수 인식이 실패하는 사례가 많습니다. 이 경우 파이썬을
C:\Python310과 같이 공백과 한글이 없는 루트 경로에 설치하는 것이 가장 안정적인 솔루션입니다.
이 문제의 보다 자세한 기술 정보나 공식 지원 내용은 아래 마이크로소프트 공식 문서를 통해 확인하실 수 있습니다.
Microsoft Support: Windows에서 앱 실행 별칭 관리하기본 가이드는 공식 문서와 검증된 솔루션을 기반으로 작성되었습니다. 레지스트리 편집이나 시스템 파일 수정 전에는 반드시 백업을 수행하세요. 문제가 지속되면 공식 지원 채널에 문의하시기 바랍니다.
댓글
댓글 쓰기