either event handler is re-entrant - cc-switch 启动失败

Quick fix

Windows 上出现该崩溃时，企业安全软件冲突场景可尝试设置 WebView2 参数；原帖未提供通用已验证修复。

Symptom

报错原文复制

either event handler is re-entrant (likely), or no event handler is registered (very unlikely)

Cause

多个 Windows 报告在 cc-switch 启动时于 tao 的 Windows 事件循环处出现同一错误，表现为无法打开界面、白屏、后台有进程或闪退。已报告的版本包括 3.9.1、3.11.1、3.14.0 和 3.14.1；这些是受影响报告版本，并非已确认的修复范围。

报告中的原因并不完全一致：安装天锐绿盾或 IP-Guard 等企业安全软件的场景被认为可能与窗口或内置浏览器相关机制冲突；其中 IP-Guard 的原因仅为发帖人的推测。另有用户在绿盾与 WebView2 冲突的情况下，通过设置 `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox` 成功解决白屏，但另一位用户反馈该方法无效。维护者还提到 Tauri 2 对系统版本要求较高，并建议尝试 CLI 版；原帖尚未提供适用于所有该错误报告的可验证解法。

Fix

1. 1

   如果电脑安装了绿盾等企业安全软件，并且症状为白屏，可尝试将系统环境变量 `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS` 设置为 `--no-sandbox`，然后重启电脑。该方法仅有一位用户确认成功，且只说明适用于绿盾与 WebView2 冲突的情况。

2. 2

   如果安装了天锐绿盾，可按讨论中的建议先关闭该软件后启动 cc-switch，再重新打开天锐绿盾；该建议未附带确认成功的反馈。

3. 3

   若上述场景不适用或仍失败，原帖尚未提供可验证的通用解法；可关注对应源 issue 的后续讨论。

Affected Versions

Toolcc-switch

Version受影响报告：3.9.1 - 3.14.1

PlatformsWindows

Source Issues

本页汇总自 5 个真实 issue

• #765windows端 启用程序白屏
• #1255cc-switch在win10 下面安装后，打开无反应
• #1530被 IP-Guard 拦截导致无法启动
• #2597Windows11上面安装使用，无法正常打开界面
• #3170cc switch和天锐绿盾软件底层冲突

FAQ

想请教下你们修改的哪些策略。

讨论中未提供具体策略列表；已确认的个案仅提到设置 `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox`，且该方法并非对所有白屏情况有效。

相关问题

检测本地codex时候会无限开检测窗口：cc-switchWindows 下检测本地 CLI 时出现窗口和进程持续堆积，原帖尚未提供可验证的解法；设置超时仅是用户提出的修复诉求。1 issues mergedEGL_BAD_PARAMETER：CC Switch Linux 白屏在受影响的 Linux AppImage 环境中，先预加载宿主机的 libwayland-client；若仍白屏，可改用使用系统组件的 .deb 包。8 issues merged无法正常启动，窗口无响应，被系统要求force quit将 CC Switch 更新到经过相关功能重构的 4.0 或最新版本后重试；若仍复现，提交完整版本、步骤、日志和截图。1 issues merged