파이썬 스레딩 프로그래밍 signal 처리 메인 스레드 전담 원리

🔗 파이썬 스레딩의 기본 이해

파이썬에서 스레드는 프로그램의 실행 흐름을 동시에 여러 개 두어, 복잡한 작업을 병렬적으로 수행할 수 있도록 돕는 중요한 기능입니다.
예를 들어, 한쪽에서는 네트워크 요청을 기다리면서도 다른 한쪽에서는 파일을 처리하거나 사용자 입력을 받을 수 있죠.
이렇게 하면 프로그램이 멈추지 않고 자연스럽게 여러 일을 수행할 수 있습니다.

파이썬은 threading 모듈을 통해 손쉽게 스레드를 만들고 관리할 수 있습니다.
스레드는 보통 함수나 객체의 메서드를 실행 대상으로 지정하여 시작하며, 각 스레드는 독립적으로 실행됩니다.
다만, 완전히 독립된 프로세스와 달리 동일한 메모리 공간을 공유하기 때문에 데이터 충돌이나 동기화 문제가 발생할 수 있습니다.
이 때문에 락(lock)이나 이벤트(event) 같은 동기화 도구가 자주 사용됩니다.

⚙️ 스레드와 프로세스의 차이

프로세스는 운영체제로부터 독립된 자원을 할당받아 실행되는 단위라면, 스레드는 하나의 프로세스 내에서 실행되는 더 작은 단위입니다.
즉, 여러 스레드는 같은 프로세스의 메모리를 공유하므로 협업이 빠르지만, 잘못 관리하면 충돌이 발생할 위험이 있습니다.

• 🛠️스레드는 메모리 공유가 가능하다
• ⚡프로세스는 독립적인 메모리를 가진다
• 📌멀티스레드는 빠르지만 동기화 관리가 필요하다

🧩 GIL(Global Interpreter Lock)의 존재

파이썬 스레딩에서 꼭 이해해야 할 개념이 바로 GIL입니다.
파이썬 인터프리터는 한 번에 하나의 스레드만 실행할 수 있도록 제한하는 Global Interpreter Lock이라는 메커니즘을 사용합니다.
이 때문에 CPU 연산을 집중적으로 수행하는 작업에서는 멀티스레딩의 이점이 제한적일 수 있습니다.
하지만 파일 입출력, 네트워크 통신처럼 대기 시간이 많은 작업에서는 오히려 큰 효과를 발휘하죠.

🛠️ signal 모듈과 메인 스레드 전담 원리

파이썬의 signal 모듈은 운영체제 수준에서 발생하는 신호를 처리하기 위해 사용됩니다.
예를 들어, 사용자가 Ctrl + C를 눌러 프로그램을 중단하려고 하면 SIGINT 신호가 발생하죠.
이때 개발자는 signal 모듈을 이용해 특정 함수(핸들러)를 등록하여 해당 신호가 들어왔을 때 원하는 동작을 실행할 수 있습니다.

하지만 중요한 점은 signal 모듈은 오직 메인 스레드에서만 작동한다는 사실입니다.
이는 파이썬 공식 문서에도 명확히 언급된 사항으로, 서브 스레드에서 signal.signal()을 호출하면 ValueError 예외가 발생합니다.
이 제약은 파이썬이 아닌 운영체제 차원에서 정의된 규칙과도 밀접한 관련이 있습니다.

📌 왜 메인 스레드만 전담할까?

운영체제는 기본적으로 신호를 프로세스 단위로 전달합니다.
그 안에서 실제 어떤 실행 단위(스레드)가 이를 처리할지는 시스템과 인터프리터가 결정합니다.
파이썬은 복잡성을 줄이고 일관된 동작을 보장하기 위해 신호 처리를 메인 스레드 전담 방식으로 설계했습니다.
이 덕분에 여러 스레드가 동시에 신호를 처리하려고 경쟁하는 혼란을 방지할 수 있습니다.

import signal
import threading
import time

def handler(signum, frame):
    print("신호 처리 중:", signum)

# 메인 스레드에서만 가능
signal.signal(signal.SIGINT, handler)

def worker():
    while True:
        time.sleep(1)
        print("작업 중...")

t = threading.Thread(target=worker)
t.start()

위 예시에서 SIGINT 신호가 발생하면, 등록된 handler가 실행됩니다.
하지만 이 코드를 서브 스레드에서 실행하려 하면 즉시 예외가 발생하므로 반드시 메인 스레드에서 설정해야 합니다.

⚙️ 서브 스레드에서 signal을 다루지 못하는 이유

파이썬에서 서브 스레드는 signal.signal()을 사용할 수 없습니다.
이는 단순히 파이썬의 제한이 아니라, 운영체제와 언어 설계 상의 결정 때문입니다.
운영체제는 신호를 프로세스 전체에 전달하며, 특정 스레드에만 직접 신호를 보내는 방식을 지원하지 않기 때문에, 파이썬은 안전성을 위해 메인 스레드 전담 원칙을 적용합니다.

서브 스레드에서 signal을 다루려 시도하면 곧바로 ValueError: signal only works in main thread라는 오류가 발생합니다.
이 오류는 초보자들이 멀티스레딩 환경에서 가장 흔히 겪는 문제 중 하나이며, 시스템 자원 관리의 복잡성을 줄이고 프로그램이 일관되게 실행되도록 하기 위한 장치입니다.

🔍 발생 가능한 문제 사례

만약 서브 스레드에서 신호를 처리하려고 하면 아래와 같은 문제가 발생할 수 있습니다.

• ⚠️서브 스레드에서 신호 핸들러 등록 시 ValueError 발생
• 💥멀티스레드 환경에서 신호 처리가 예측 불가능해질 위험
• 🌀데드락이나 잘못된 자원 해제 등 프로그램 불안정성 초래

📌 올바른 접근 방식

서브 스레드에서는 신호를 직접 처리하는 대신, 이벤트 객체(event)나 큐(queue)를 사용해 메인 스레드가 받은 신호를 전달받아 동작하는 것이 올바른 방식입니다.
즉, 신호 처리 자체는 메인 스레드에서 수행하고, 그 결과를 서브 스레드가 참고하도록 설계해야 합니다.

💬 signal은 메인 스레드의 책임, 서브 스레드는 메인 스레드가 전달하는 이벤트만 처리한다.

🔌 안전한 signal 처리 패턴과 활용 예시

멀티스레드 환경에서 신호를 안전하게 처리하려면 메인 스레드와 서브 스레드 간의 역할을 명확히 나눠야 합니다.
메인 스레드는 signal 모듈을 통해 신호를 받고, 서브 스레드는 메인 스레드가 전달하는 이벤트나 플래그를 기반으로 동작하는 구조를 사용하는 것이 핵심입니다.

이런 패턴을 적용하면 SIGINT, SIGTERM 같은 종료 신호가 들어왔을 때 모든 스레드를 안전하게 종료시킬 수 있습니다.
아래는 이벤트 객체를 활용해 신호를 처리하는 대표적인 예시 코드입니다.

import signal
import threading
import time

stop_event = threading.Event()

def handler(signum, frame):
    print("종료 신호 감지:", signum)
    stop_event.set()

signal.signal(signal.SIGINT, handler)
signal.signal(signal.SIGTERM, handler)

def worker(name):
    while not stop_event.is_set():
        print(f"{name} 작업 중...")
        time.sleep(1)
    print(f"{name} 종료 완료")

threads = [threading.Thread(target=worker, args=(f"스레드-{i}",)) for i in range(2)]

for t in threads:
    t.start()

for t in threads:
    t.join()

위 코드에서 메인 스레드는 SIGINT와 SIGTERM 신호를 감지하고 stop_event를 설정합니다.
서브 스레드는 이 이벤트를 지속적으로 확인하면서 안전하게 종료됩니다.
이 방식은 예측 가능한 종료와 자원 정리를 가능하게 하여 실무에서 자주 활용됩니다.

💡 활용할 수 있는 패턴

💡 실무에서 자주 쓰이는 스레드 신호 처리 방법

실무에서는 단순한 예제 이상의 복잡한 상황에서 신호 처리를 적용해야 할 때가 많습니다.
예를 들어, 네트워크 서버, 데이터 수집기, 장시간 실행되는 배치 작업 등은 갑작스러운 종료 신호가 들어와도 안전하게 종료되어야 하며, 이를 위해 다양한 패턴이 활용됩니다.

대표적인 접근 방식은 메인 스레드가 신호를 전담하고, 서브 스레드가 이를 반영할 수 있도록 설계하는 것입니다.
이 과정에서 logging 모듈과 결합하여 상태를 기록하거나, try-finally 구문으로 자원 해제를 보장하는 것이 일반적입니다.

📌 실무 패턴 예시

• 🛠️메인 스레드에서 signal.signal()로 종료 신호 처리
• 📡이벤트 객체나 큐를 활용해 서브 스레드로 전달
• 📖신호 감지 시 로그 기록으로 추적 가능성 확보
• ✅try-finally 구문으로 DB 연결, 파일 핸들러 등 자원 정리

🔍 실제 적용 시 주의사항

실제 시스템에서는 단순히 스레드를 멈추는 것만으로 충분하지 않을 수 있습니다.
예를 들어, DB에 데이터를 기록하는 중이라면 중간 상태에서 끊기지 않도록 트랜잭션 정리가 필요하고, 네트워크 소켓을 사용 중이라면 연결 종료 절차가 반드시 필요합니다.

❓ 자주 묻는 질문 (FAQ)