You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Ubuntu 22.04升级后Flutter安装/更新失败(TLS错误)

Flutter 安装/更新故障排查方案(Ubuntu 22.04)

核心问题定位

从错误信息(无法连接Flutter仓库、Git克隆失败)来看,大概率是Git网络配置异常或系统SSL证书未同步导致,并非普通防火墙/基础网络问题。


具体修复步骤

1. 清理Git代理残留配置

Ubuntu版本升级后可能遗留无效代理设置,执行以下命令清理:

git config --global --unset http.proxy
git config --global --unset https.proxy

若需使用代理,重新配置为正确地址:

git config --global http.proxy http://你的代理地址:端口
git config --global https.proxy https://你的代理地址:端口

2. 重置系统SSL证书

Ubuntu 22.04的证书库可能未同步,执行更新命令:

sudo apt update && sudo apt install --reinstall ca-certificates
sudo update-ca-certificates

3. 切换Flutter国内镜像(针对国内网络环境)

设置官方国内镜像源,规避网络限制:

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

如需永久生效,将上述两行添加到~/.bashrc或~/.zshrc文件末尾,再执行:

source ~/.bashrc # 若用zsh则执行 source ~/.zshrc

4. 手动克隆Flutter仓库

若自动安装/升级仍失败,直接用Git克隆稳定版仓库:

git clone https://github.com/flutter/flutter.git -b stable

克隆完成后将Flutter加入环境变量:

export PATH="$PATH:`pwd`/flutter/bin"

同样可将该行添加到~/.bashrc/~/.zshrc实现永久生效。

5. 验证Git仓库连通性

测试与Flutter仓库的连接是否正常:

git ls-remote https://github.com/flutter/flutter.git

若返回仓库分支信息,说明网络连接正常;若失败,可尝试切换DNS为8.8.8.8:

sudo nano /etc/resolv.conf
# 修改或添加:nameserver 8.8.8.8

内容的提问来源于stack exchange,提问作者Lalit Poptani

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.22 04:34:58