CC Switch online update freezes and becomes unresponsive
Quick fix
CC Switch online update can freeze under FlClash TUN mode. Switch to system proxy mode or manually download and reinstall.
Symptom
Section titled “Symptom”每次在应用内点击「检查更新」并执行在线更新时，整个应用窗口完全冻结无响应——无法点击、无法移动窗口、无法关闭，只能强制退出进程。Every time I click "Check for updates" in the app and run the online update, the entire app window freezes and becomes unresponsive: it cannot be clicked, moved, or closed, and the process must be force-quit.
The update component in CC Switch (`tauri-plugin-updater`) uses the `reqwest` HTTP client without a timeout. When using TUN mode in proxy tools such as FlClash, especially with Fake-IP DNS, the TLS handshake or data transfer can stall. Without a timeout, the async task hangs indefinitely, the frontend `await` never returns, and the WebView JavaScript event loop is blocked, freezing the app UI. The GlobalProxy environment variable set by CC Switch may also interfere with the updater's own requests.
Switch the proxy tool, such as FlClash, from TUN mode to system proxy mode, then retry the online update.
If it still freezes, manually download the latest installer from GitHub Releases or the GitCode mirror and install it over the existing installation.
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”This page is distilled from 1 real issues
- After force-stopping the frozen update, the app opens as the new version. Did the update succeed?
- Yes. The background download and replacement likely completed, but the UI thread was blocked while waiting for a network response. The version loaded after the forced restart is the new one.
Related problems
Section titled “Related problems”This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.