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
相关产品推荐
相关产品推荐

