在线更新时卡死无响应 CC Switch

Quick fix

在 FlClash TUN 模式下 CC Switch 在线更新会卡死，请切换为系统代理模式或手动下载覆盖安装。

Symptom

报错原文复制

每次在应用内点击「检查更新」并执行在线更新时，整个应用窗口完全冻结无响应——无法点击、无法移动窗口、无法关闭，只能强制退出进程。

Cause

CC Switch 的更新组件（`tauri-plugin-updater`）使用的 `reqwest` HTTP 客户端未设置超时时间。当使用 FlClash 等代理工具的 TUN 模式（特别是配合 Fake-IP DNS）时，TLS 握手或数据传输可能会卡住。由于缺少超时机制，异步任务会永久挂起，导致前端 `await` 永不返回，进而阻塞 WebView 的 JavaScript 事件循环，造成整个应用 UI 线程卡死无响应。此外，CC Switch 自身的 GlobalProxy 环境变量也可能干扰更新器的独立请求。

Fix

1. 1

   将代理工具（如 FlClash）从 TUN 模式切换为系统代理模式（System Proxy），然后重试在线更新。

2. 2

   如果切换后仍然卡死，请手动从 GitHub Releases 或 GitCode 镜像仓库下载最新版本的安装包进行覆盖安装。

Affected Versions

ToolCC Switch

Version3.16.2

PlatformsmacOS

Source Issues

本页汇总自 1 个真实 issue

• #4089在线更新时卡死无响应（FlClash TUN 模式 + reqwest 无超时）

FAQ

更新卡死后强制停止，重新打开发现变成了新版本，这是更新成功了吗？

是的，这说明后台下载和替换可能已经完成，只是 UI 线程在等待网络响应时被阻塞导致假死。强制重启后加载的即为新版本。

相关问题

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。4 issues merged401 Unauthorized: Incorrect API key provided切换到 OpenAI Official 或关闭代理后，需手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 并重启 Codex 以恢复官方 OAuth 登录。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。7 issues merged