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

如何解决Flutter iOS构建时出现的Ruby相关ffi LoadError报错?

问题原因

该报错是macOS自带的2.6版本系统Ruby与ffi 1.15.4依赖版本不兼容导致的,M系列芯片的Mac设备触发该问题的概率更高,系统Ruby的读写权限限制也会导致依赖加载失败。

解决方案

按以下步骤操作即可解决:

  • 优先使用非系统版本的Ruby,避免修改系统Ruby触发权限问题,可通过Homebrew安装新版Ruby:
    1. 若未安装Homebrew可先完成安装,已安装直接跳过该步
    2. 执行命令安装Ruby:brew install ruby
    3. 根据你使用的终端类型配置环境变量:
      • zsh终端:M系列芯片执行 echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc,Intel芯片执行 echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc,执行完成后运行 source ~/.zshrc 生效
      • bash终端:将上述命令中的~/.zshrc替换为~/.bash_profile后执行即可
    4. 执行ruby -v验证版本,确认输出不是2.6.x的系统版本即为配置成功
  • 重新安装ffi依赖:
    通用安装命令:sudo gem install ffi
    若仍报错可指定架构安装:M系列芯片执行sudo arch -arm64 gem install ffi,Intel芯片执行sudo arch -x86_64 gem install ffi
  • 清理Flutter项目iOS缓存后重新构建:
    1. 进入项目ios目录:cd ios
    2. 清理旧的依赖文件:rm -rf Pods Podfile.lock
    3. 重新安装iOS依赖:pod install
    4. 返回项目根目录重新执行Flutter iOS构建命令即可

内容的提问来源于stack exchange,提问作者satheesh ck

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.26 15:39:04