Flutter配置amplify_analytics_pinpoint_android报错无法在模拟器运行

错误表现 #

在模拟器上运行Flutter应用时出现启动失败问题，构建过程触发项目配置异常，具体报错信息如下：

What went wrong:
A problem occurred configuring project ':amplify_analytics_pinpoint_android'.
> this and base files have different roots

报错触发于:amplify_analytics_pinpoint_android项目配置环节，核心错误提示翻译为：当前文件与基准文件存在根路径不一致。

常见触发原因 #

• 项目存放路径包含跨盘符软链接、网络映射盘挂载，Gradle解析依赖路径时识别到不匹配的根目录
• Windows环境下自定义Gradle缓存、Flutter SDK存储路径时，和项目所在目录分属不同盘符的独立挂载分区
• 历史构建缓存损坏，导致依赖路径解析逻辑异常
• 引入的amplify_analytics_pinpoint_android版本和当前Android构建链版本不兼容，存在路径解析已知bug

修复方案 #

按顺序尝试以下操作即可解决：

• 路径合规检查
  不要把项目放在网络映射盘、跨盘符软链接目录下；确认项目全路径、Flutter SDK路径、Gradle缓存路径没有中文、特殊空格、异常字符，Windows环境下尽量不要将三个路径分散在不同的独立挂载盘符下。
• 全量清理缓存
  在项目根目录依次执行以下命令清理损坏的旧缓存：

  flutter clean
  cd android
  ./gradlew clean
  cd ..
  flutter pub get
  

• 依赖版本校准
  如果清理缓存后仍报错，打开项目根目录下的pubspec.yaml文件，将Amplify相关依赖升级到和当前Flutter、Android Gradle插件版本匹配的稳定正式版，避开存在路径解析bug的旧迭代版本。
• Windows系统额外配置
  打开本地组策略编辑器，找到「计算机配置>管理模板>系统>文件系统>启用Win32长路径」选项并启用，避免长路径被系统截断导致的根路径识别错误。

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