메인 스크립트에서 발생하는 CX_Freeze Python 오류 해결 방법

일부 Windows 사용자들은 시스템이 부팅될 때마다 'CX_Freeze Python Error in Main Script'라는 시작 오류가 반복해서 나타난다고 보고하고 있습니다. 대부분의 경우 이 문제는 서드파티 프로그램을 제거한 이후에 발생하는 것으로 알려져 있습니다. 흥미롭게도 이 문제는 특정 운영체제에 국한되지 않으며, Windows 7, Windows 8.1, Windows 10 등 다양한 버전에서 동일하게 보고되고 있습니다.

이 문제가 보고된 사례의 대부분은 Python으로 작성된 애플리케이션(주로 Raptr 또는 PlayTV)이 원인입니다. 해당 경우라면 문제가 되는 앱을 제거하기만 하면 해결할 수 있습니다. 일반적인 방식(프로그램 및 기능 메뉴)으로 제거하거나, 강력한 서드파티 언인스톨러를 활용할 수도 있습니다.

반면 Steam에서 실행한 게임에서 이 오류가 발생한다면, AppData 폴더에 쌓인 임시 파일들로 인해 발생한 문제일 가능성이 높습니다. 이 경우 AppData 폴더 내용을 정리한 뒤 게임을 재설치하면 문제가 해결됩니다.

또한 로컬에서 직접 빌드한 Python 프로젝트를 실행할 때 이 오류가 나타난다면, 설치된 cx_freeze 패키지에 패치 누락이 있는 것이 원인일 수 있습니다. 이 경우 CMD 창에서 cx_freeze 패키지 전체를 제거한 후 최신 버전을 다시 설치하면 됩니다.

위 방법 모두 실패했다면, Windows 구성 요소를 초기화하지 않고도 문제를 해결할 수 있는 마지막 수단으로 시스템 파일 손상을 복구해 주는 유틸리티(DISM과 SFC)를 실행해 보세요.

Raptr 또는 PlayTV 제거하기

앞서 언급했듯이 'CX_Freeze Python Error in Main Script' 시작 오류를 유발하는 가장 흔한 원인은 Python으로 일관성 없이 작성된 소프트웨어입니다. 실제로 많은 사용자들이 문제의 원인이 Raptr 또는 PlayTV였다고 확인했습니다.

해당 사례에 해당한다면, 시작 오류의 원인으로 의심되는 프로그램을 강제로 제거하여 문제를 해결할 수 있습니다.

제거 방법은 크게 두 가지입니다. 전통적인 방식(프로그램 및 기능 화면에서 제거)을 사용하거나, 강력한 서드파티 언인스톨러를 활용하는 것입니다. 먼저 일반적인 방법을 시도하고, 실패할 경우 두 번째 방법으로 넘어가는 것을 권장합니다.

프로그램 및 기능에서 제거하기

1. Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 텍스트 입력란에 'appwiz.cpl'을 입력하고 Enter 키를 눌러 프로그램 및 기능 메뉴를 엽니다.
2. 프로그램 및 기능 메뉴에 들어가면 설치된 애플리케이션 목록을 아래로 스크롤하면서 PlayTV, Raptr 또는 'CX_Freeze Python Error in Main Script' 시작 오류를 유발하는 것으로 의심되는 프로그램을 찾습니다.
3. 문제가 되는 애플리케이션을 찾았다면 마우스 오른쪽 버튼으로 클릭하고, 나타나는 컨텍스트 메뉴에서 제거를 선택합니다.
4. 제거 확인 창이 나타나면 화면의 안내에 따라 제거를 완료한 후 컴퓨터를 재시작하고, 다음 시스템 시작 시 문제가 해결되었는지 확인합니다.

동일한 문제가 계속 발생한다면 아래로 스크롤하여 서드파티 언인스톨러 사용 방법을 진행하세요.

언인스톨러 소프트웨어 사용하기

1. 기본 브라우저를 열고 해당 링크(여기)에 접속하여 Revo Uninstaller의 최신 무료 버전을 다운로드하고 설치합니다. 페이지에 접속한 후 Download 버튼을 클릭하여 다운로드를 시작하세요.

   참고: Revo의 포터블 버전은 InstallShield 버전만큼 효과적이지 않으므로 사용하지 않는 것이 좋습니다.

2. 설치 파일이 완전히 다운로드되면 더블클릭하여 화면의 지침에 따라 설치를 완료합니다.

   참고: UAC(사용자 계정 컨트롤) 창이 나타나면 예를 클릭하여 관리자 권한을 부여합니다.

3. Revo Uninstaller 앱에 들어간 후 상단 세로 메뉴에서 언인스톨러 탭을 선택하고, 설치된 애플리케이션 목록을 스크롤하여 PlayTV 또는 Raptr(또는 둘 다)와 관련된 항목을 찾습니다.
4. PlayTV 또는 Raptr 항목을 마우스 오른쪽 버튼으로 클릭하고, 나타나는 컨텍스트 메뉴에서 제거를 선택합니다.

   참고: 두 애플리케이션이 모두 설치되어 있다면 이 단계와 이후 단계를 각각에 대해 모두 수행하세요.

5. 다음 창에서 복원 지점 생성이 완료될 때까지 기다린 후, 스캔 모드에서 Advanced를 선택하고 Scan을 클릭하여 남아 있는 잔여 파일들을 제거합니다.
6. 화면의 안내에 따라 제거를 완료한 후, 자동으로 재시작되지 않으면 컴퓨터를 직접 재시작합니다.
7. 다음 부팅 과정에서 시작 오류가 여전히 나타나는지 주의 깊게 확인하여 'CX_Freeze Python Error in Main Script' 오류가 해결되었는지 점검합니다.

동일한 문제가 계속 발생한다면 아래의 다음 해결 방법으로 넘어가세요.

cx_Freeze 스크립트 재설치하기 (해당되는 경우)

cx_freeze로 빌드한 Python 프로젝트의 실행 파일을 실행하려 할 때 'CX_Freeze Python Error in Main Script' 시작 오류가 발생한다면, 현재 사용 중인 cx_freeze 설치 환경에 패치가 누락되었을 가능성이 높습니다.

해당 사례에 해당한다면 CMD 창에서 cx_freeze 패키지 전체를 제거한 후 공식 경로를 통해 최신 버전을 다시 설치하면 문제를 해결할 수 있습니다.

전체 과정을 단계별로 안내해 드리겠습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 텍스트 입력란에 'cmd'를 입력하고 Enter 키를 눌러 명령 프롬프트 터미널을 엽니다.
2. 명령 프롬프트 터미널에 다음 명령어를 입력하고 Enter 키를 눌러 cx_freeze 패키지 전체를 제거합니다.

   pip uninstall cx_freeze

3. 패키지 제거 준비가 완료되면 선택을 확인하라는 메시지가 표시됩니다. Y 키를 누른 후 다시 Enter 키를 눌러 cx_freeze 패키지의 제거를 완료합니다.
4. 다음으로 기본 브라우저를 열어 해당 링크(여기)에 접속합니다. 페이지에 들어가면 Python 확장 패키지용 비공식 Windows 바이너리(Unofficial Windows Binaries for Python Extension Packages) 목록을 볼 수 있습니다.
5. 바이너리 목록을 아래로 스크롤하여 cx_Freeze 항목을 찾고, 현재 사용 중인 Python 버전에 맞는 항목을 찾습니다. 찾았다면 호환되는 버전을 클릭하고 다운로드가 완료될 때까지 기다립니다.
6. 다운로드가 완료되면 다운로드 위치로 이동하여 실행 파일을 마우스 오른쪽 버튼으로 클릭하고, 나타나는 컨텍스트 메뉴에서 관리자 권한으로 실행을 선택합니다.
7. 설치 화면에서 자신의 Python 버전을 선택하고 화면의 지침에 따라 설치를 완료합니다.
8. 설치가 완료되고 새 버전의 cx_freeze가 설치되면 Python 프로젝트를 다시 빌드하여 문제가 해결되었는지 확인합니다.

동일한 문제가 계속 발생하거나 이 방법이 적용되지 않는다면, 아래의 다음 해결 방법으로 넘어가세요.

게임의 AppData 폴더 정리하기

Python으로 만든 게임을 실행하려 할 때 'CX_Freeze Python Error in Main Script' 오류가 나타난다면, AppData 폴더에 손상된 임시 데이터가 존재할 가능성이 있습니다.

동일한 문제를 겪었던 여러 사용자들이 게임의 AppData 폴더에 접근하여 임시 파일을 삭제한 뒤 게임을 재설치함으로써 오류를 완전히 제거하고 정상적으로 게임을 즐길 수 있었다고 확인했습니다.

해당 사례에 해당한다면, 아래 지침에 따라 게임 실행 시 나타나는 'CX_Freeze Python Error in Main Script' 오류를 해결해 보세요.

1. Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 그런 다음 '%appdata%'를 입력하고 Enter 키를 눌러 AppData 폴더(기본적으로 숨겨져 있음)를 엽니다.
2. AppData 폴더에 들어가면 뒤로 가기 화살표를 클릭하여 한 단계 위로 이동한 후 Local 폴더를 클릭합니다.
   

   참고: 기본적으로 %appdata% 명령은 Appdata 내의 Roaming 폴더를 자동으로 엽니다.

3. Local 폴더 안에서 'CX_Freeze Python Error in Main Script' 오류가 발생하는 게임 관련 정보를 담고 있는 항목을 찾습니다. 찾았다면 해당 폴더를 열고 내부의 모든 항목을 선택한 후 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴에서 삭제를 선택합니다.
4. Windows 키 + R을 다시 눌러 실행 대화 상자를 엽니다. 그런 다음 'appwiz.cpl'을 입력하고 Enter 키를 눌러 프로그램 및 기능 화면을 엽니다.
5. 프로그램 및 기능 메뉴에서 설치된 프로그램 목록을 스크롤하여 문제가 발생하는 게임과 관련된 항목을 마우스 오른쪽 버튼으로 클릭하고, 컨텍스트 메뉴에서 제거를 선택합니다.
6. 제거가 완료되면 컴퓨터를 재시작하고 일반적인 방법으로 게임을 다시 설치한 후 문제가 해결되었는지 확인합니다.

여전히 'CX_Freeze Python Error in Main Script' 오류가 나타나거나 이 방법이 적용되지 않는다면, 아래의 다음 해결 방법으로 넘어가세요.

DISM 및 SFC 검사 실행하기

위의 어떤 해결 방법으로도 문제가 해결되지 않는다면, 컴퓨터가 일반적인 방법으로는 해결할 수 없는 시스템 파일 손상을 겪고 있을 가능성이 높습니다. 대부분의 경우 'CX_Freeze Python Error in Main Script' 시작 오류는 제대로 제거되지 않은(사용자가 일반적인 방법을 따랐더라도) 불완전하게 작성된 프로그램 때문에 발생합니다.

해당 사례에 해당한다면, Windows에 내장된 유틸리티(DISM과 SFC)를 사용하여 이 문제를 일으키는 손상된 시스템 파일을 식별하고 복구함으로써 문제를 해결할 수 있습니다.

SFC(시스템 파일 검사기)는 완전히 로컬에서 작동하는 도구로, 로컬에 저장된 캐시를 사용하여 손상된 파일을 정상적인 복사본으로 교체합니다. 반면 DISM(배포 이미지 서비스 및 관리) 도구는 Windows Update의 하위 구성 요소를 통해 손상된 파일을 교체할 정상 파일을 가져오기 때문에 안정적인 인터넷 연결이 필요합니다.

이 두 도구는 서로 보완적인 역할을 하므로, 'CX_Freeze Python Error in Main Script' 문제를 일으키는 시스템 파일 손상 문제를 해결할 가능성을 극대화하기 위해 두 검사를 연달아 실행하는 것을 권장합니다.

SFC 검사를 수행하려면 여기의 단계별 지침을 따르세요. 작업이 완료되면 컴퓨터를 재시작하고, 다음 부팅이 완료된 후 DISM 검사를 진행합니다.

두 검사를 모두 마친 후 최종적으로 컴퓨터를 한 번 더 재시작하고, 시작 오류가 더 이상 나타나지 않는지 확인합니다.