Flutter应用在iOS Simulator运行报NSPOSIXErrorDomain错误如何解决

问题核心原因 #

报错提示的「文件名过长」是核心触发点：iOS模拟器安装应用时的临时 staging 路径本身层级就很深，当你的项目源路径嵌套层级多、内部资源文件路径过长时，复制过程总路径会超出macOS系统的路径长度限制，就会触发该错误。实体iOS设备安装逻辑和模拟器不同，因此不会触发该问题。

可直接落地的解决方案 #

• 最简单见效的方案是缩短项目根目录的存放路径：把项目从多层嵌套的文件夹（比如~/Documents/公司业务/2024年项目/某某客户端/flutter/）移动到浅层级目录，比如直接放在~/Projects/下，减少源路径的总长度。
• 修改Xcode构建输出路径：打开项目ios目录下的Runner.xcodeproj，在Xcode左侧项目导航栏点击Runner根项目，选择Build Settings，搜索Build Products Path，将默认的相对路径改成短路径，比如/tmp/flutter_ios_build，避免构建产物本身路径过长。
• 重置对应模拟器：打开Xcode顶部菜单 -> Window -> Devices and Simulators，找到报错提示的UUID为3597CFAA-C3AA-444E-94A9-826F707ED584的模拟器，右键选择「Erase All Content and Settings」，清空模拟器缓存后重新运行项目。
• 简化项目内资源文件命名：检查项目中嵌套存放的图片、字体、配置等资源，如果有单个文件名过长、或者嵌套层级超过5层的情况，适当简化命名、减少嵌套层级，降低单个资源的总路径长度。

验证方法 #

修改完成后先执行flutter clean，再执行flutter run启动模拟器即可。

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