Windows 환경에서 시스템 트레이가 복제되는 현상

[eun-yeon]

@claude

Taskbar의 앱 이름 클릭 시 새 인스턴스가 실행되는 현상과 동시에 시스템 트레이에 있는 아이콘도 복제가 되는 문제가 있었습니다.
인스턴스 복제 문제는 Windows 전역 Named Mutex를 사용하여 단일 인스턴스를 보장하는 코드를 추가해 해결하였는데, 시스템 트레이 복제 현상도 해결이 되었는지 분석해 주세요.
서브 에이전트를 호출하여 상세 코드 리뷰 부탁드립니다.

[claude]

Claude finished @eun-yeon's task in 2m 41s —— View job

---

시스템 트레이 복제 현상 코드 분석 결과

• 이슈 분석 및 작업 계획 수립
• CLAUDE.md 및 프로젝트 구조 파악
• 단일 인스턴스(Named Mutex) 관련 코드 탐색
• 시스템 트레이 관련 코드 탐색
• 서브 에이전트를 통한 상세 코드 리뷰
• 결과 정리 및 코멘트 업데이트

---

A. Named Mutex 구현 여부

현재 코드베이스에 Named Mutex(단일 인스턴스 보호) 코드가 존재하지 않습니다.

main.rs, app_state.rs, 모든 .rs 파일을 검색한 결과 CreateMutex, OpenMutex, WaitForSingleObject, tauri-plugin-single-instance 등 관련 코드가 전혀 없습니다. ipc.rs에 존재하는 Named Pipe는 키보드 데몬과의 IPC 통신용으로, 단일 인스턴스 보호와 무관합니다.

즉, 이슈에서 언급된 "Named Mutex로 인스턴스 복제 문제를 해결했다"는 수정이 아직 이 브랜치에 반영되지 않은 상태입니다.

---

B. 현재 트레이 아이콘 생성 가드 분석

app_state.rs:130-180 — ensure_tray_icon_for_background()

pub fn ensure_tray_icon_for_background(&self, app: &AppHandle) -> Result<()> {
    if app.tray_by_id(TRAY_ICON_ID).is_some() {  // 중복 방지 가드
        return Ok(());
    }
    // ... 트레이 아이콘 생성
}

이 가드는 동일 프로세스 내 중복은 막지만 다른 프로세스에서의 중복은 막지 못합니다.

시나리오	결과	이유
같은 프로세스 내 중복 호출	✅ 차단됨	AppHandle이 동일 프로세스 내 인메모리 상태를 공유
새 프로세스(2번째 인스턴스) 실행	❌ 차단 안 됨	새 프로세스는 별도의 AppHandle을 가지며, 기존 트레이 아이콘 상태를 알지 못함

결론: 두 번째 인스턴스가 실행되면 각 프로세스가 독립적으로 "트레이 아이콘이 없다"고 판단하여 각자 트레이 아이콘을 생성 → 복제 현상 발생.

---

C. Named Mutex가 트레이 복제 문제도 해결하는가?

YES — Named Mutex 단일 인스턴스 보호를 적용하면 트레이 복제 문제도 함께 해결됩니다.

인과 관계:

Named Mutex 적용
  → 두 번째 프로세스 실행 차단
  → 하나의 프로세스만 존재
  → ensure_tray_icon_for_background()는 단 한 번의 프로세스에서만 호출
  → 트레이 아이콘이 하나만 생성됨

단, 아래 엣지 케이스에서는 여전히 복제 가능성이 있습니다:

엣지 케이스	위험도	설명
프로세스 크래시 후 뮤텍스 미해제	높음	좀비 프로세스가 뮤텍스를 점유 중이면, 재실행 시 두 인스턴스가 공존 가능
빠른 연속 실행 중 경쟁 조건	중간	첫 번째 프로세스가 종료 중이고 뮤텍스를 아직 해제하지 않은 상태에서 두 번째 프로세스가 뮤텍스 획득 후 진행하면 잠시 두 인스턴스 공존 가능

---

D. 기타 트레이 관련 코드 리뷰 결과

1. 트레이 제거 후 창 표시 순서 문제 (app_state.rs:1292-1306)

fn show_main_window(app_handle: &AppHandle) -> Result<()> {
    if let Some(main) = app_handle.get_webview_window("main") {
        let _ = main.unminimize();
        main.show()?;  // 창 표시
        let _ = main.set_focus();
    }

    if app_handle.tray_by_id(TRAY_ICON_ID).is_some() {
        let _ = app_handle.remove_tray_by_id(TRAY_ICON_ID);  // 트레이 제거
    }
    ...
}

트레이 메뉴에서 "Settings" 클릭 시 트레이가 즉시 삭제됩니다. 만약 창 표시(show())가 실패하면 트레이도 없고 창도 없는 상태가 되어 앱에 접근 불가 상태가 될 수 있습니다.

2. 트레이 생성 실패 시 창 숨김 문제 (app_state.rs:1247-1258)

api.prevent_close();
if let Err(err) = main_window.hide() { ... }  // 창 먼저 숨김
if let Err(err) = state.set_main_window_hidden(true) { ... }
if let Err(err) = state.ensure_tray_icon_for_background(&app_handle) {
    log::warn!("failed to create tray icon: {err}");
    // ← 여기서 실패해도 숨겨진 창을 복구하는 로직 없음
}

창을 먼저 숨긴 후 트레이 생성에 실패하면, 사용자가 앱에 접근할 수 없는 상태가 됩니다. main.rs:429에는 이를 복구하는 로직이 있지만, attach_main_window_close_handler(위 코드)에는 없습니다.

3. tray_enabled 설정 변경 시 경쟁 조건 (app_state.rs:1035-1044)

if let Some(enabled) = diff.changed.tray_enabled {
    if !enabled {
        let _ = app.remove_tray_by_id(TRAY_ICON_ID);  // 트레이 제거
        ...
    } else if self.store.snapshot().main_window_hidden {
        self.ensure_tray_icon_for_background(app)?;  // 트레이 생성
    }
}

설정 변경 중 키보드 데몬 스레드가 동시에 ensure_tray_icon_for_background()를 호출하면 경쟁 조건이 발생할 수 있습니다.

---

종합 평가

항목	심각도	파일	영향
Named Mutex 미구현	🔴 높음	main.rs	다중 인스턴스 실행 가능, 트레이 복제 발생
크로스 프로세스 트레이 복제	🔴 높음	app_state.rs:130	트레이 아이콘 중복 표시
트레이 제거 후 창 표시 순서	🟡 중간	app_state.rs:1292	창/트레이 모두 사라지는 경우 발생 가능
트레이 생성 실패 시 복구 없음	🟡 중간	app_state.rs:1254	앱 접근 불가 상태
설정 변경 경쟁 조건	🟡 중간	app_state.rs:1035	트레이 생성/삭제 불안정
크래시 후 뮤텍스 미해제 엣지케이스	🟡 중간	Named Mutex 구현 시	재실행 시 두 인스턴스 공존 가능

Named Mutex로 단일 인스턴스를 보장하면 트레이 복제 현상의 주된 원인은 해결되나, 위에서 언급한 트레이 관련 엣지케이스들(특히 D-1, D-2)도 함께 검토하시길 권장합니다.

[eun-yeon]

@claude 이 문제를 수정하면 윈도우와 맥 모두 시스템 트레이 오류가 해결될까요?

[claude]

Claude finished @eun-yeon's task in 2m 28s —— View job

---

윈도우/맥 시스템 트레이 오류 해결 여부 분석

• 이슈 분석 및 작업 계획 수립
• 코드베이스에서 플랫폼별 단일 인스턴스 처리 확인
• macOS 트레이 관련 코드 분석
• 최종 분석 결과 작성

---

결론 요약

Windows의 Named Mutex 수정은 macOS 트레이 복제 문제를 해결하지 않습니다. 두 플랫폼의 단일 인스턴스 처리 구조가 완전히 다르기 때문입니다.

---

플랫폼별 현재 아키텍처

항목	Windows	macOS
단일 인스턴스 잠금	없음 (구현 예정)	Dock Helper (NSRunningApplication 활용)
활성화 정책	기본값	Accessory (앱이 독에 표시 안 됨)
트레이 아이콘 구현	Tauri 내장	Tauri 내장 (동일 코드)
다중 인스턴스 실행 가능?	✅ 가능	✅ 가능
트레이 복제 발생 가능?	✅ 발생	✅ 발생

---

Windows — Named Mutex가 해결하는 범위

Named Mutex는 Windows 전용 OS API입니다. Windows에 Named Mutex를 적용하면:

두 번째 인스턴스 실행 시도
  → OS가 Mutex 점유 중임을 감지
  → 두 번째 프로세스 실행 차단
  → 트레이 아이콘이 하나의 프로세스에서만 생성
  → 트레이 복제 해결 (Windows만 해당)

macOS에는 CreateMutex API 자체가 없으므로, 이 수정은 macOS에 아무런 영향을 주지 않습니다.

---

macOS — 현재 단일 인스턴스 처리 방식

macOS는 Dock Helper(src-tauri/helper/DockHelper/main.swift)를 통해 활성화를 처리합니다.

Dock Helper 동작 방식 (main.swift:111-137):

// 독 아이콘 클릭 시 기존 인스턴스를 활성화
if let running = NSRunningApplication
    .runningApplications(withBundleIdentifier: mainBundleId)
    .first(where: { !$0.isTerminated }) {
    running.activate(options: [.activateIgnoringOtherApps])
    return
}

핵심 문제: Dock Helper는 UX 레벨의 활성화만 처리하며, 프로세스 레벨의 중복 실행을 차단하지 않습니다.

• 사용자가 독 아이콘을 클릭하면 → 기존 인스턴스를 앞으로 가져옴 ✅
• 하지만 앱을 직접 이중 실행하면 → 두 개의 프로세스가 공존 가능 ❌

---

트레이 중복 방지 가드의 한계

현재 app_state.rs:131-133의 가드:

pub fn ensure_tray_icon_for_background(&self, app: &AppHandle) -> Result<()> {
    if app.tray_by_id(TRAY_ICON_ID).is_some() {
        return Ok(());
    }
    // 트레이 생성...
}

이 가드는 프로세스 내부 메모리만 확인합니다. 두 번째 인스턴스는 자신의 Tauri 컨텍스트에서 "트레이 없음"으로 판단하여 독립적으로 트레이를 생성합니다.

인스턴스 1: tray_by_id() → None → 트레이 생성 → 시스템 트레이에 아이콘 1개
인스턴스 2: tray_by_id() → None → 트레이 생성 → 시스템 트레이에 아이콘 2개 (복제)

---

플랫폼별 해결 방법

Windows

Named Mutex 구현으로 해결 가능:

#[cfg(windows)]
fn ensure_single_instance() -> Option<windows::Win32::Foundation::HANDLE> {
    use windows::Win32::System::Threading::CreateMutexW;
    // ...
}

macOS

macOS에서 트레이 복제를 방지하려면 별도의 처리가 필요합니다:

1. tauri-plugin-single-instance 사용 (크로스 플랫폼 권장):

   # Cargo.toml
   tauri-plugin-single-instance = "2"

   Windows(Named Mutex)와 macOS(파일 기반 락 또는 socket) 모두를 추상화하여 처리합니다.

2. macOS 파일 락 (flock) 사용:

   #[cfg(target_os = "macos")]
   fn ensure_single_instance_mac() { ... }

3. Dock Helper 강화: 이미 실행 중인 인스턴스 감지 시, 새 인스턴스에게 종료 신호 전송

---

종합 판단

수정 사항	Windows 트레이 복제 해결	macOS 트레이 복제 해결
Named Mutex (Windows 전용)	✅ 해결	❌ 미해결
tauri-plugin-single-instance (크로스 플랫폼)	✅ 해결	✅ 해결
macOS 전용 파일 락 추가	❌ 미해결	✅ 해결

권장 접근법: tauri-plugin-single-instance를 사용하면 Windows와 macOS를 단일 코드로 처리할 수 있습니다. 이 플러그인은 내부적으로 플랫폼에 맞는 방법(Windows: Named Mutex, macOS/Linux: 소켓/파일 기반)을 사용합니다.

현재 Dock Helper(main.swift)는 독 클릭 시 활성화 목적으로 유지하면서, 단일 인스턴스 보장은 tauri-plugin-single-instance에 위임하는 구조가 가장 안정적입니다.