在线更新时卡死无响应 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

本页汇总自 2 个真实 issue

• #4089在线更新时卡死无响应（FlClash TUN 模式 + reqwest 无超时）
• #1264feat: ProviderProxyConfig 支持直连模式，绕过系统代理访问内网供应商

FAQ

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

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

相关问题

401 Unauthorized升级到 cc-switch 4.0.x；或手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 后重启 Codex，重新走 ChatGPT OAuth 登录。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。8 issues mergedcc-switch 用量统计与 DeepSeek 官网不一致 / 不更新先升级到 v3.19.2 或更新版本，然后在「使用统计」页执行一次「重建 Codex 用量」，历史虚增或漏记的数据才会被修正。22 issues merged