Flutter iOS Release构建失败求助：全新项目报头文件缺失错误

问题描述 #

我之前在Mac服务器上用IntelliJ和Xcode成功构建过多个Flutter iOS Release版本应用，但现在突然无法完成Release构建。为排查是不是应用自身的问题，我在服务器的IntelliJ里从头创建了一个全新项目，完成框架配置（指定Flutter安装路径）后，这个项目能正常在模拟器构建运行，但执行命令行指令flutter build ios进行Release构建时却报错。现在哪怕是默认项目也出现这个问题，请问是不是和服务器有关？

报错信息如下：

74-80-250-218:untitled userxxxxx$ flutter build ios
Building com.burrito.untitled for device (ios-release)...
Automatically signing iOS for device deployment using specified development team in Xcode project: xxxxxxxxxx
Running Xcode build...
├─Building Dart code... 22.7s
├─Generating dSYM file... 0.2s
├─Stripping debug symbols... 0.0s
├─Assembling Flutter resources... 1.2s
└─Compiling, linking and signing... 0.2s
Xcode build done. 26.2s
Failed to build iOS app
Error output from Xcode build:
↳ ** BUILD FAILED **
Xcode's output:
↳ In file included from /Users/userxxxxxx/Desktop/untitled/ios/Runner/GeneratedPluginRegistrant.m:5:
/Users/userxxxxxx/Desktop/untitled/ios/Runner/GeneratedPluginRegistrant.h:8: 9: fatal error: 'Flutter/Flutter.h' file not found
#import <Flutter/Flutter.h>
        ^~~~~~~~~~~~~~~~~~~
1 error generated.
In file included from /Users/userxxxxx/Desktop/untitled/ios/Runner/GeneratedPluginRegistrant.m:5:
/Users/userxxxxxx/Desktop/untitled/ios/Runner/GeneratedPluginRegistrant.h:8: 9: fatal error: 'Flutter/Flutter.h' file not found
#import <Flutter/Flutter.h>
        ^~~~~~~~~~~~~~~~~~~
1 error generated.
Encountered error while building for device.

解决方案 #

我之前在服务器环境下遇到过一模一样的问题，大概率是Flutter SDK和Xcode的依赖关联出了问题——服务器环境经常会因为系统更新、权限变动或者缓存损坏导致这类框架引用错误。下面是几个亲测有效的排查修复步骤：

1. 确认Flutter和Xcode的基础环境状态 #

• 运行flutter doctor，仔细查看输出里的Xcode相关提示，比如有没有提示“Flutter.framework not found”或者权限相关的警告
• 执行which flutter，对比IntelliJ里配置的Flutter SDK路径是否一致，确保命令行使用的是同一个SDK

2. 重置iOS项目的Pod依赖 #

这是最常见的修复手段，步骤如下：

• 进入项目的ios目录：cd ios
• 执行pod deintegrate彻底清除现有Pod依赖
• 删除Podfile.lock文件和Pods文件夹
• 回到项目根目录，执行flutter pub get
• 再回到ios目录执行pod install

3. 修复Xcode项目的框架搜索路径 #

有时候自动配置的路径会出问题，手动确认一下：

• 用Xcode打开项目的Runner.xcworkspace文件（注意不是xcodeproj）
• 选中Runner目标，进入Build Settings标签
• 搜索Framework Search Paths，检查是否包含${FLUTTER_ROOT}/bin/cache/artifacts/engine/ios这个路径，如果没有就手动添加
• 另外确认Header Search Paths里是否有${FLUTTER_ROOT}/bin/cache/artifacts/engine/ios

4. 清除Flutter和Xcode的缓存 #

缓存损坏是服务器环境的常见问题：

• 在项目根目录执行flutter clean清除Flutter项目缓存
• 打开Xcode，点击菜单Product > Clean Build Folder清除Xcode的构建缓存
• 重启IntelliJ和Xcode，再尝试flutter build ios

5. 检查服务器的权限设置 #

服务器用户的权限经常会因为运维操作变动：

• 确认当前用户对Flutter SDK目录和Xcode安装目录（一般是/Applications/Xcode.app）有读写权限
• 执行sudo xcodebuild -license accept，确保已经接受Xcode的许可协议（有时候服务器更新后许可会失效）

如果以上步骤都试过还是不行，可以尝试重新下载Flutter SDK替换现有版本，或者更新Xcode到最新稳定版——服务器环境的版本滞后也可能导致这类兼容性问题。

内容的提问来源于stack exchange，提问作者FuriousBunny