1. 소개
우리가 이렇게 쓸 때
worker.WorkCompleted += listener.OnWorkCompleted;
실제로는 이벤트의 "호출 목록"(multicast delegate)에 메서드에 대한 포인터를 추가하는 거예요. 이벤트 내부의 이 "목록"은 이벤트가 발생했을 때 호출될 메서드들의 순서일 뿐입니다. C#에서 이벤트는 여러 구독자를 지원하는 델리게이트 위에 구현되어 있습니다.
뉴스레터를 떠올려보세요: 구독자 목록(이메일 주소들)이 있고, 뉴스레터를 보낼 때(이벤트 호출) 모든 구독자가 메일을 받습니다. 누군가 구독을 취소하면 목록에서 제거되어 더 이상 메일을 받지 않죠.
구독자를 추가하거나 제거하는 방법
구독(+=)과 구독 해제(-=)는 이벤트 내부의 델리게이트와 작동합니다. 다음은 람다를 구독하고 해제하는 예제입니다:
EventHandler<WorkCompletedEventArgs> handler = (sender, e) =>
{
Console.WriteLine($"[람다] 작업 완료: {e.Message}");
};
worker.WorkCompleted += handler; // 구독 추가
worker.WorkCompleted -= handler; // 구독 해제
일반 메서드의 경우도 해제는 동일하게 작동합니다:
worker.WorkCompleted += listener.OnWorkCompleted;
worker.WorkCompleted -= listener.OnWorkCompleted;
주의: 같은 메서드를 여러 번 구독하면 그만큼 여러 번 호출됩니다. 따라서 같은 횟수만큼 -=를 호출해야 완전히 해제됩니다.
2. 왜 수동으로 관리해야 할까?
구독자를 관리하는 것이 왜 중요할까?
실제 애플리케이션, 특히 오래 실행되는 앱(데스크톱이나 서버 등)에서는 구독 관리를 잘못하면 메모리 누수가 발생할 수 있습니다. 구독자 객체가 더 이상 필요없어도 이벤트의 구독 목록에 남아 있으면 델리게이트가 그 객체를 참조하기 때문에 가비지 컬렉터가 해당 객체를 해제하지 못합니다.
예시
| 동작 | 구독자에 대한 결과 |
|---|---|
| += (구독함) | 목록에 추가됨 |
| -= (구독 해제) | 목록에서 제거됨 |
| 구독자 객체가 제거됨 | 구독을 해제하지 않았다면! — 제거되지 않음, 이벤트에 여전히 참조가 있기 때문 |
| 구독자 객체가 제거됨 | 구독을 해제했다면 정상적으로 제거됨 |
이벤트에 누가 구독했는지 어떻게 알 수 있나?
이벤트는 구독자 목록을 캡슐화하므로, 발행자 클래스 외부에서는 직접 목록을 얻을 수 없습니다 — +=로 추가하거나 -=로 제거할 수만 있죠.
하지만 델리게이트 기반으로 이벤트가 선언된 클래스 내부(예: EventHandler 기반)라면 GetInvocationList()를 사용해 현재 구독자 목록을 얻을 수 있습니다:
// 발행자 클래스 내부
if (WorkCompleted != null)
{
foreach (Delegate subscriber in WorkCompleted.GetInvocationList())
{
Console.WriteLine($"핸들러: {subscriber.Method.Name}, 객체: {subscriber.Target}");
}
}
이 방법은 일상 개발에서는 드물게 필요하지만 디버깅이나 모든 구독자를 일괄 해제하는 기능을 구현할 때 유용할 수 있습니다.
3. 안전한 이벤트 호출: 함정들과 회피법
이벤트 호출 시 무엇이 잘못될 수 있나?
보통은 이렇게 호출합니다
WorkCompleted?.Invoke(this, args);
대부분의 경우 잘 동작합니다... 하지만 몇 가지 미묘한 문제가 있습니다. 다음을 주의하세요:
1. 멀티스레드 위험
멀티스레드 환경에서는 이벤트를 null이 아닌지 검사한 시점과 실제 호출 시점 사이에 다른 스레드가 구독을 변경할 수 있습니다. 예를 들어:
1) 스레드 A가 WorkCompleted != null인지 검사한다.
2) 같은 순간 스레드 B가 이벤트에서 구독을 해제(-=)하여 호출자 목록이 비게 된다.
3) 스레드 A가 WorkCompleted.Invoke(...)를 호출하려 하면 NullReferenceException이 발생할 수 있다 — 이미 핸들러가 없는 상태니까요.
이건 이벤트 작업에서 발생하는 전형적인 레이스 컨디션입니다.
2. 핸들러에서의 예외
구독자 중 하나가 이벤트 처리 중 예외를 던지면 이후 핸들러의 호출이 중단됩니다. 즉 첫 번째 예외에서 이벤트 호출이 끊기고 나머지 구독자는 알림을 받지 못합니다. 모든 구독자에게 신호를 주는 것이 중요하다면 각 핸들러 호출을 try-catch로 감싸는 것이 권장됩니다.
3. 의도치 않은 참조 유지(메모리 누수)
이벤트 핸들러는 인스턴스 메서드인 경우 구독자 객체(this)에 대한 참조를 캡처합니다. 구독자가 이벤트 발행자에서 구독 해제를 잊으면 델리게이트 목록에 참조가 남아 있어 가비지 컬렉터가 그 객체를 회수하지 못합니다 — 메모리 누수가 생깁니다.
이벤트를 안전하게 호출하려면?
1) 델리게이트를 로컬 변수로 복사
로컬 변수로 호출하면 호출하는 동안 목록이 변경되지 않는다는 보장이 더 큽니다:
// 기본적인 방법
var handler = WorkCompleted;
if (handler != null)
{
handler(this, args);
}
또는 null-conditional 연산자(?.)를 쓰면 더 간단합니다:
WorkCompleted?.Invoke(this, args);
대부분의 경우 이 정도면 충분합니다. C# 컴파일러는 이 패턴을 이해하고 내부적으로 참조를 복사해 주기도 합니다(자세한 내용은 공식 문서 참조).
2) 핸들러 예외로부터 보호
모든 핸들러가 호출되는 것이 중요하다면 수동으로 순회하세요:
var handler = WorkCompleted;
if (handler != null)
{
foreach (EventHandler<WorkCompletedEventArgs> subscriber in handler.GetInvocationList())
{
try
{
subscriber(this, args);
}
catch (Exception ex)
{
// 로그는 남기되 이벤트 전체가 실패하지 않게 함
Console.WriteLine($"핸들러에서의 오류: {ex.Message}");
}
}
}
이 방식은 일반적인 UI 시나리오에서는 드물게 필요하지만, 라이브러리나 로거, 복잡한 시스템에서는 유용합니다.
3) 메모리 누수 방지
구독자의 수명이 발행자보다 짧다면(예: 창이 애플리케이션 이벤트에 구독한 경우) 구독자는 반드시 구독을 해제해야 합니다:
worker.WorkCompleted -= listener.OnWorkCompleted;
그렇지 않으면 garbage collector가 listener를 회수하지 못할 수 있습니다, 설령 다른 명시적 참조가 없더라도.
4. 실용 예제: 구독 일괄 관리기
학습용 앱을 확장해 봅시다. 구독자가 여러 명 있고 프로그램 실행 중 동적으로 구독/해제를 하고 싶다고 합시다.
public class WorkListener
{
private readonly string _name;
public WorkListener(string name)
{
_name = name;
}
public void OnWorkCompleted(object sender, WorkCompletedEventArgs e)
{
Console.WriteLine($"Listener {_name}: {e.Message}");
}
}
메인 프로그램에서:
var worker = new Worker();
var listeners = new List<WorkListener>
{
new WorkListener("이반"),
new WorkListener("마리아"),
new WorkListener("데니스")
};
// 모든 리스너 구독
foreach (var listener in listeners)
worker.WorkCompleted += listener.OnWorkCompleted;
// 이벤트 호출
worker.DoWork();
// 일괄 구독 해제
foreach (var listener in listeners)
worker.WorkCompleted -= listener.OnWorkCompleted;
// 더 이상 반응하지 않는지 확인
worker.DoWork();
첫 번째 작업 후 콘솔에는 3개의 메시지가 출력되고, 두 번째 작업 후에는 아무 것도 출력되지 않습니다.
5. 이벤트를 안전하게 다루는 팁
- 구독자의 수명이 발행자보다 짧다면 제때 구독 해제하세요.
- 만약 «오래 사는 발행자 — 일시적 구독자» 패턴을 구현한다면, Dispose()나 창 닫기 등 객체의 명시적 종료 시점에 반드시 구독 해제를 하세요.
- 일회성 이벤트는 익명 람다를 사용하고 내부에서 바로 구독 해제하는 패턴을 쓸 수 있습니다:
EventHandler<WorkCompletedEventArgs> handler = null;
handler = (s, e) =>
{
Console.WriteLine("이벤트가 한 번만 처리되었어!");
worker.WorkCompleted -= handler;
};
worker.WorkCompleted += handler;
- 누가 구독했는지 확인하려고 굳이 구독자나 핸들러 참조를 저장하지 마세요 — 일반적인 비즈니스 로직에서는 불필요합니다. 디버깅 목적으로만 하세요.
6. 자주 하는 실수와 피하는 방법
실수 #1: 이벤트 구독 해제를 잊음 — 메모리 누수.
구독자가 구독 해제를 하지 않으면, 특히 이벤트와 구독자가 많은 큰 앱에서는 객체들이 필요 이상으로 메모리에 남아 있을 수 있습니다. 이런 문제는 즉시 드러나지 않는 경우가 많아 메모리 사용량 증가와 성능 저하로 이어집니다.
실수 #2: null 체크 없이 이벤트 호출.
이벤트에 구독자가 없는 상태에서 직접 호출하면 NullReferenceException이 발생할 수 있습니다. 최신 C#에서는 안전 호출 연산자 ?.가 도움이 되지만, 오래된 코드거나 핸들러를 수동으로 순회할 때는 null 체크를 잊지 마세요.
실수 #3: 한 핸들러의 예외가 나머지 호출을 중단시킴.
핸들러 중 하나가 예외를 던지면 이후 핸들러는 호출되지 않습니다. 모든 구독자에게 알림을 보내야 한다면 각 호출을 루프에서 돌며 try/catch로 감싸세요.
GO TO FULL VERSION