Odevio 构建报错:安装 Flutter 失败 Error code 33
结论
Odevio 报出的 Error code 33 不是 Flutter、Xcode 或 iOS 构建链里公开的标准错误码,单看这个编号判断不出它指什么。从日志能确定的是:Odevio 在构建 VM 的准备阶段执行 Flutter 安装命令时失败了,33 大概率是安装脚本或底层命令返回的退出码。你贴出的日志里只有构建开始和停止时间,没有安装 Flutter 的 stdout/stderr,所以下一步要先拿到安装阶段的详细日志,再按网络、权限、磁盘、Flutter 版本与缓存、Odevio 环境支持范围这几项逐条排查。
可能原因
- 构建 VM 下载 Flutter SDK 时网络受限,或代理配置和本地不一致。
- Flutter 安装目录、缓存目录或临时目录没有写权限。
- 构建 VM 磁盘空间不够。
- Odevio 侧配置的 Flutter 版本或 channel 与项目、本地环境不兼容。
- Flutter SDK 缓存损坏,或上一次安装的残留导致重复安装失败。
- Odevio 的构建镜像、工具链与当前 Flutter 版本的组合不在支持范围内。
本地 flutter doctor 正常、pod install 也成功,只能说明本地环境没问题,说明不了构建 VM 里安装 Flutter 的条件同样正常。
排查与解决步骤
-
先向 Odevio 获取安装阶段的详细日志
如果 Odevio 构建配置里提供 verbose/debug 日志选项,就先打开它;提交支持请求时附上构建时间、项目配置以及下面这段信息:
Build started at 2026-10-04 12:32:44.715722+00:00 Build stop order received at 2026-10-04 12:34:52.100651+00:00同时直接问 Odevio 支持:
Error code 33对应安装 Flutter 的哪条命令,退出码是怎么映射的。缺了这一步,很容易朝着错误的方向反复试。 -
固定并核对 Flutter 版本
先在本地确认项目用的 Flutter 版本:
flutter --versionOdevio 如果允许指定 Flutter 版本,就固定成和本地一致的 stable 版本,不要用会漂移的 channel 或没验证过的最新版。现在用的是 beta/master 的话,先切回 stable 再试:
flutter channel stable flutter upgrade flutter --versionflutter upgrade会改动本地 SDK,执行前先确认项目允许升级。 -
检查构建 VM 的网络与代理
准备阶段要下载 Flutter SDK、Dart 包和 Git 依赖,确认 Odevio 的构建环境能访问 Flutter SDK 下载源、
pub.dev以及项目用到的 Git 仓库。项目如果在本地依赖代理或镜像,构建 VM 也要配上同一套;只在本机设置代理,对 Odevio 的 VM 没有作用。Odevio 支持自定义环境变量的话,可以按团队的网络策略设置可信的镜像或代理,别随手用来源不明的镜像。
-
清理 Flutter 与 iOS 缓存后重新构建
先在本地做一次干净构建,排除项目侧缓存的影响:
flutter clean flutter pub get rm -rf ios/Pods ios/Podfile.lock pod install --repo-update flutter build ios --no-codesignOdevio 如果有“清理构建缓存/重新创建 VM”的选项,也执行一次。同一个构建不要不做清理就连续重复提交。
-
检查磁盘空间和目录权限
Odevio 允许在构建前跑诊断脚本的话,把这些信息输出来交给支持人员:
df -h echo "$HOME" ls -ld "$HOME" /tmp git --version重点看 Flutter 安装目录、
$HOME、/tmp能不能写,磁盘是不是已经满了。 -
缩小项目范围做对照构建
新建一个最小的 Flutter 项目,在 Odevio 上构建一次。最小项目也报
Error code 33,问题更可能出在 Odevio 的 Flutter 安装环境;最小项目正常,再把原项目的依赖、插件和 iOS 配置逐步加回去。
注意事项
Error code 33别直接当成 Xcode 或 CocoaPods 的错误处理,当前失败点在安装 Flutter,不在实际编译。- 本地
pod install成功,不代表问题已经解决,Odevio 构建 VM 是独立环境。 - Odevio 支持工单的话,提交时要求对方提供安装 Flutter 命令的完整输出和退出码含义,这是确认根因最快的办法。
备注:内容仅供参考。
