执行flutter build ios时因SPM路径编码错误及插件不兼容失败

核心问题原因 #

Flutter 3.44.1稳定版和Xcode 16的SPM集成逻辑存在兼容问题，当项目路径包含空格时（比如Work Drive），路径会被两次URL编码（变成Work%2520Drive），导致xcodebuild无法正确解析路径找到pubspec.yaml，再加上部分插件不支持SPM，进一步触发构建失败。

有效解决方法 #

1. 最简单粗暴：移到无空格路径

直接把项目文件夹从带空格的路径（比如~/Work Drive/MyFlutterApp）移动到无空格的路径（比如~/WorkDrive/MyFlutterApp），彻底规避路径编码问题。移动后执行：

flutter clean
flutter pub get
cd ios && pod install
flutter build ios

2. 禁用Flutter的SPM自动集成

既然部分插件不支持SPM，直接关闭Flutter的SPM自动集成功能：

• 方法一：在项目根目录新建/修改flutter_build_config.yaml，添加以下内容：

  target: ios
  ios:
    disable_swift_package_manager: true
  

• 方法二：修改ios/Podfile，找到flutter_install_all_ios_pods那一行，修改为：

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)), disable_spm: true
  

修改完成后，执行以下命令重新构建：

flutter clean
flutter pub get
cd ios && pod install --repo-update
flutter build ios

3. 手动修复Xcode路径编码（备选）

如果不想移动项目，可以尝试手动修正Xcode中的路径编码：

• 打开Xcode，进入项目的Build Settings，搜索PACKAGE_RESOLVER_URL或类似的SPM相关路径设置；
• 把其中的%2520替换为%20（或者直接使用空格），保存后重新构建。

也可以在执行构建命令时手动转义路径：

flutter build ios --project-path "$(echo ~/Work\ Drive/MyFlutterApp | sed 's/ /%20/g')"

不过这个方法稳定性不如前两个，优先推荐前两种方案。

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