Flutter iOS构建失败：UIImage无imageByPreparingForDisplay方法

核心原因分析 #

imageByPreparingForDisplay是iOS 10.0及以上系统才提供的UIImage扩展API，出现这个错误大概率是项目iOS部署目标版本低于10.0，或是SDWebImage依赖版本与项目环境不兼容。

具体解决步骤 #

1. 确认iOS部署目标版本 #

• 打开iOS目录下的Podfile，确保顶部平台版本设置为10.0或更高：

  platform :ios, '10.0'
  

• 打开Xcode，进入项目target的Build Settings，找到iOS Deployment Target，确认版本≥10.0

2. 清理Pod缓存并重新安装依赖 #

执行以下命令彻底清理Pod相关缓存和配置：

cd ios
pod deintegrate
pod cache clean --all
rm -rf Podfile.lock
pod install

3. 锁定兼容的SDWebImage版本 #

如果降级操作无效，尝试在Podfile中指定明确的兼容版本（比如对iOS 10+支持稳定的5.12.0版本）：

pod 'SDWebImage', '~> 5.12.0'

4. 排查Flutter插件的间接依赖 #

部分Flutter插件会间接引入SDWebImage，可通过以下命令查看依赖版本冲突：

pod outdated

• 若发现插件强制引入不兼容版本，更新对应Flutter插件到最新版；
• 或在Podfile中添加重定向规则锁定版本：

  pod 'SDWebImage', :git => 'https://github.com/SDWebImage/SDWebImage.git', :tag => '5.12.0'
  

5. 验证Xcode编译设置 #

• 确认Xcode项目Build Settings中，Enable Modules (C and Objective-C)设置为YES；
• 执行Product > Clean Build Folder清理编译缓存后重新构建项目

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