📚 PyQt5 스택 오버플로우 문제 해결 마스터 청사진

💡 상황 해독

• 현재 상태: PyQt5로 개발한 프로그램을 exe로 빌드했을 때 Windows 10에서 "BuymaCollector.exe의 작동이 중지되었습니다" 오류와 함께 스택 오버플로우(0xc00000fd) 발생
• 핵심 쟁점:
• Windows 11에서는 정상 작동하지만 Windows 10에서만 크래시 발생
• PyQt5 버전을 바꿔도 동일한 문제 지속
• Qt5Gui.dll과 Qt5Core.dll에서 반복적인 스택 오버플로우 오류
• 터미널 실행으로도 내부 로그를 확인할 수 없음
• 예상 vs 현실: PyQt5 버전 문제로 예상했지만, 실제로는 코드 내 무한 재귀 호출이 원인
• 영향 범위: 프로그램 완전 다운, 사용자 경험 저하, 배포 불가능, 개발 일정 지연

🔍 원인 투시

• 근본 원인: 이벤트 루프 재진입과 시그널 연결 미정리로 인한 무한 재귀 호출 패턴
• 연결 고리: 로그 메시지 출력 시 QApplication.processEvents() 호출 → 이벤트 루프 재진입 → 동일 함수 재호출 → 스택 오버플로우
• 일상 비유:
• 거울 앞에서 거울을 들고 서로를 비추면 끝없이 반복되는 상황
• 전화상담원이 A고객 응대 중 B고객 전화를 받고, B 응대 중 또 C고객 전화를 받는 무한 중첩
• 회의 중에 다른 회의 참석하고, 그 회의에서 또 다른 회의 참석하는 상황
• 숨겨진 요소:
• Windows 버전별 Qt 호환성 차이
• PyInstaller 임시 폴더 실행 환경
• 명시적으로 해제되지 않은 시그널-슬롯 연결
• 종료 과정의 복잡한 호출 관계

🛠️ 해결 설계도

1. 이벤트 루프 재진입 차단하기

• 핵심 행동: log_message 함수에서 QApplication.processEvents() 호출 제거
• 실행 가이드:

1. 코드에서 log_message 함수 찾기
2. QApplication.processEvents() 라인 주석 처리 또는 삭제
3. 빌드 후 테스트

• 성공 지표: 로그는 여전히 출력되지만 무한 재귀 없이 프로그램이 안정적으로 실행됨
• 예시/코드:

// 변경 전
def log_message(self, message: str):
    timestamp = time.strftime("[%H:%M:%S]")
    full_message = f"{timestamp} {message}"
    self.log_text_edit.append(full_message)
    print(full_message)
    QApplication.processEvents() # 위험한 재진입 코드

// 변경 후
def log_message(self, message: str):
    timestamp = time.strftime("[%H:%M:%S]")
    full_message = f"{timestamp} {message}"
    self.log_text_edit.append(full_message)
    print(full_message)
    # QApplication.processEvents() 제거 - 무한 재귀 방지

// 핵심 변화 설명
이벤트 루프 재진입을 방지하여 스택 오버플로우 원인을 제거했습니다.

• 주의사항: UI 갱신이 약간 지연될 수 있으나 안정성이 우선

1. 스레드 정리 시 시그널 연결 완전 해제

• 핵심 행동: 워커 스레드 종료 전 모든 시그널 연결을 명시적으로 해제
• 실행 가이드:

1. 스레드 종료 관련 메서드 찾기
2. try-except 블록으로 시그널 해제 코드 추가
3. 스레드 정리 후 None 할당

• 성공 지표: 스레드 종료 시 메모리 사용량 정상 감소, 관련 오류 메시지 없음
• 예시/코드:

// 변경 전
if self.worker_thread and self.worker_thread.isRunning():
    self.worker_thread.stop()
    self.worker_thread.wait(1000)
    self.worker_thread = None

// 변경 후
if self.worker_thread and self.worker_thread.isRunning():
    try:
        # 모든 시그널 연결 해제
        self.worker_thread.log_signal.disconnect()
        self.worker_thread.progress_signal.disconnect()
        self.worker_thread.finished_signal.disconnect()
    except Exception:
        pass  # 이미 해제된 시그널 예외 처리
    self.worker_thread.stop()
    self.worker_thread.wait(1000)
    self.worker_thread = None

// 핵심 변화 설명
스레드 종료 전 시그널 연결을 완전히 정리하여 메모리 누수와 재귀 호출을 방지합니다.

• 주의사항: 모든 시그널을 빠짐없이 나열해야 하며, 예외 처리 필수

1. 종료 이벤트 재귀 방지 플래그 추가

• 핵심 행동: closeEvent와 종료 관련 함수에 재귀 호출 방지 플래그 설정
• 실행 가이드:

1. closeEvent 함수 찾기
2. 함수 시작 부분에 재귀 방지 플래그 체크 추가
3. finally 블록으로 플래그 초기화 보장

• 성공 지표: 프로그램 종료 시 오류 없이 깨끗하게 종료됨
• 예시/코드:

// 변경 전
def closeEvent(self, event):
    msg_box = QMessageBox(self)
    # ... 종료 로직

// 변경 후
def closeEvent(self, event):
    if hasattr(self, '_closing') and self._closing:
        event.accept()
        return
    
    self._closing = True
    try:
        msg_box = QMessageBox(self)
        # ... 종료 로직
    finally:
        self._closing = False

// 핵심 변화 설명
재귀 호출 방지 플래그로 closeEvent가 중복 실행되는 것을 차단합니다.

• 주의사항: finally 블록으로 예외 상황에서도 플래그 초기화 보장

🧠 핵심 개념 해부

• 이벤트 루프: GUI 프로그램의 심장박동
• 5살에게 설명한다면: 놀이공원 회전목마처럼 계속 돌면서 "버튼 눌렀어요", "창 닫으세요" 같은 요청을 하나씩 처리하는 시스템
• 실생활 예시: 식당 웨이터가 테이블을 돌아다니며 주문받고 음식 서빙하는 방식
• 숨겨진 중요성: 한 번에 하나씩만 처리해야 안정적이며, 중첩 실행하면 혼란 발생
• 오해와 진실: processEvents()를 자주 호출하면 UI가 빨라질 것 같지만 실제로는 무한 재귀의 원인
• 시그널-슬롯: 객체 간 메시지 전달 시스템
• 5살에게 설명한다면: 친구가 "점심시간!"하고 외치면(시그널) 다른 친구들이 정해진 행동(슬롯)을 하는 것
• 실생활 예시: 화재경보기(시그널)가 울리면 소방관(슬롯)이 출동하는 시스템
• 숨겨진 중요성: 연결된 시그널은 명시적으로 해제하지 않으면 메모리에 계속 남아있음
• 오해와 진실: 자동으로 정리된다고 생각하지만 실제로는 개발자가 직접 관리해야 함
• 스택 오버플로우: 함수 호출의 과부하
• 5살에게 설명한다면: 접시를 계속 쌓다가 너무 높아져서 무너지는 것처럼, 함수가 자기를 계속 부르다가 메모리가 넘치는 현상
• 실생활 예시: 거울 앞에서 거울을 들고 끝없이 반사되는 상황
• 숨겨진 중요성: GUI 프로그램에서는 이벤트 처리 과정에서 암묵적으로 발생할 수 있음
• 오해와 진실: 직접적인 재귀 호출이 아니어도 이벤트 루프를 통해 간접적으로 발생 가능

🔮 미래 전략 및 지혜

• 예방 전략:
• 이벤트 핸들러에서 processEvents() 사용 금지 원칙
• 모든 시그널 연결과 함께 해제 코드도 작성하는 습관
• 종료 관련 함수에 항상 재귀 방지 장치 추가
• 장기적 고려사항: 이벤트 기반 프로그래밍의 복잡성을 이해하고 방어적 코딩 습관 형성
• 전문가 사고방식: "이 코드가 어떻게 실패할 수 있을까?"를 항상 고민하는 방어적 접근
• 학습 로드맵: PyQt5 이벤트 모델 → 시그널-슬롯 메커니즘 → 멀티스레딩 → 디자인 패턴

🌟 실전 적용 청사진

• 즉시 적용:
• 모든 processEvents() 호출 제거 또는 재진입 방지 조치
• 스레드 종료 코드에 시그널 해제 추가
• closeEvent에 재귀 방지 플래그 적용
• 중기 프로젝트: 자동 시그널 관리 유틸리티 클래스 개발, 애플리케이션 종료 프로세스 표준화
• 숙련도 점검: 복잡한 사용자 시나리오 테스트, 메모리 프로파일링, 코드 리뷰
• 추가 리소스: PyQt5 공식 문서, Qt 버그 리포트, Python GUI 프로그래밍 서적

📝 지식 압축 요약

PyQt5 스택 오버플로우 문제는 버전 이슈가 아닌 이벤트 루프 재진입과 시그널 연결 미정리로 인한 무한 재귀가 원인이며, processEvents() 제거, 시그널 명시적 해제, 재귀 방지 플래그 적용으로 해결할 수 있습니다. 이는 방어적 프로그래밍의 중요성을 보여주며, GUI 개발에서 이벤트 기반 사고의 필요성을 강조합니다.