从Windows迁移到Mac的Flutter项目运行报URISyntaxException错误如何解决

问题根因 #

报错中携带的是Windows系统的D盘绝对路径，项目从Windows迁移到Mac后，缓存文件、配置文件中残留了Windows端的硬编码路径，触发了URI语法异常，常规flutter clean无法完全清除这类残留。

解决方案 #

• 手动删除项目下的四个目录：android/build、android/app/build、项目根目录的build文件夹、.dart_tool文件夹，彻底清理跨系统残留的编译缓存。
• 检查android/local.properties、android/build.gradle、android/app/build.gradle配置文件，移除其中残留的Windows端SDK路径、项目路径配置，可直接删除local.properties文件后重新打开项目，IDE会自动生成适配Mac的配置。
• 检查pubspec.yaml、项目中自定义的资源引用代码，确认没有硬编码的Windows本地绝对路径，全部调整为项目相对路径。
• 执行flutter pub get重新拉取依赖，之后正常编译运行即可。

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