“event handler is re-entrant” 报错或启动闪退 - cc-switch

Quick fix

卸载 Windows 更新 KB5081263 或等待 cc-switch 升级以规避 TAO EventLoop 重入导致的崩溃与界面不渲染问题。

Symptom

报错原文复制

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

Cause

该问题由底层 GUI 框架 TAO (v0.34.6) 在 Windows 平台的事件循环（EventLoop）处理缺陷引起。当 cc-switch 在 Tauri setup 阶段同步调用 window.show() 时，若系统环境触发事件处理器重入或缺失注册，会导致应用启动后瞬间闪退（如 Issue #5414），或后台进程正常运行但主窗口无法渲染（如 Issue #5186）。部分用户定位到特定 Windows 累积更新（KB5081263）会破坏该事件循环机制，致使 setup 流程完全不执行。上游 TAO 项目已在相关议题中确认此时序竞争问题，cc-switch 需通过延后首次窗口显示时机来规避。

尽管不同用户反馈的表现形式略有差异（有的表现为进入界面停留 2-3 秒自动退出，有的表现为主窗口 HWND 存在但始终不渲染），但根因均指向同一套 Windows 事件循环调度机制与 TAO 框架的兼容性问题，修复方案一致。

Fix

1. 1

   检查并卸载可能引发冲突的 Windows 系统更新 KB5081263，随后重启电脑验证 cc-switch 是否能正常启动并显示界面。

2. 2

   若因企业策略或系统限制无法卸载该补丁，请暂时回退至旧版 cc-switch 或等待官方发布包含 EventLoop 时序修复的新版本，期间可尝试通过命令行或托盘图标唤醒窗口。

Affected Versions

Toolcc-switch

Version3.12.3 - 3.18.0

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #5186Windows 10 下启动后后台正常运行，但主窗口始终不显示（HWND 存在，疑似 Tao EventLoop 重入）
• #5414闪退

FAQ

为什么重装系统或切换版本（如 16.4、17.0）依然闪退？

因为根本原因在于 Windows 系统底层更新（如 KB5081263）与 TAO 框架 v0.34.6 的事件循环存在兼容性冲突，而非 cc-switch 自身配置或本地文件损坏。重装系统若保留了相同补丁或联网恢复更新，问题仍会复现。

如何确认我的系统是否受此 Windows 更新影响？

在 PowerShell 中运行 winver 查看版本号，并在“设置 > 更新和安全 > 查看更新历史记录”中确认是否安装了 2026-04-03 发布的 KB5081263。若已安装且出现上述症状，即可确认为同一根因。

相关问题

EGL_BAD_PARAMETER 白屏报错 cc-switch改用 .deb 或 AUR 原生包安装，或通过 LD_PRELOAD 预加载系统库运行 AppImage 以解决 ABI 冲突。6 issues merged原子替换失败 os error 50将 Claude Code 配置目录从 WSL 路径改回 Windows 本地路径，或回退至 v3.19.0。1 issues mergedWarmup request downgraded to model在 CC Switch 中关闭 Copilot 的 warmupDowngrade 选项，防止请求被静默替换为 gpt-5-mini。5 issues merged