在 CentOS 上运行 Flutter 报错,通常不是 Flutter 本身的问题,而是 系统依赖、权限、环境或架构 不满足要求。下面按「最常见原因 → 解决方式」给你总结一下。
Flutter 依赖大量 Linux 原生库。
典型报错:
error while loading shared librarieslibGL.so.1: cannot open shared object fileFailed to load dynamic library解决:
sudo yum install -y \
glibc \
libstdc++ \
zlib \
fontconfig \
freetype \
mesa-libGL \
mesa-libEGL \
libX11 \
libXext \
libXrender \
gtk3 \
nspr \
nss \
alsa-lib
✅ 推荐 CentOS 7+,CentOS 6 不建议
运行:
flutter doctor
如果提示 Chrome 错误:
sudo yum install -y chromium
或手动安装 Chrome:
sudo yum install -y https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
Flutter 需要 Git ≥ 2.14
检查:
git --version
CentOS 默认 Git 太老(1.8)
升级 Git:
sudo yum install -y https://packages.endpoint.com/rhel/7/os/x86_64/endpoint-repo-1.7-1.x86_64.rpm
sudo yum install -y git
Flutter 必须在 PATH 中
export PATH="$PATH:$HOME/flutter/bin"
永久生效:
echo 'export PATH="$PATH:$HOME/flutter/bin"' >> ~/.bashrc
source ~/.bashrc
Flutter 官方只支持 x86_64
检查:
uname -m
❌ arm / aarch64 官方不支持
✅ 只能自己编译或换系统
flutter runflutter build apk
flutter build web
flutter doctor -v
把输出贴出来,能直接定位问题。
Failed to find Chrome
✅ 安装 Chromium
ProcessException: Process exited abnormally
✅ 多半是 Git 或权限问题
Gradle build failed
✅ 检查 JDK(推荐 JDK 17 或 11)
java -version
| 项目 | 推荐 |
|---|---|
| 系统 | CentOS 7 / 8 |
| JDK | 11 或 17 |
| Git | ≥ 2.30 |
| 内存 | ≥ 4G |
| 架构 | x86_64 |
你可以直接贴:
flutter doctor -v 输出cat /etc/redhat-release)我可以一步步帮你修到能跑 ✅