Windows重命名用户目录后如何调整修复Flutter应用运行故障？

问题根因 #

报错核心原因是修改Windows用户文件夹名称后，Flutter全局Pub缓存路径仍指向旧的用户目录C:\Users\Admn\，导致无法读取缓存的devtools等依赖包。Google SignIn失效多为Android签名配置文件中的keystore路径仍使用旧用户名路径，签名校验不通过导致。

原始报错信息：

Unhandled exception:
Invalid argument(s): A directory corresponding to fileSystemPath
"C:\Users\Admn\AppData\Local\Pub\Cache\hosted\pub.dartlang.org\devtools-2.6.0\build" could not
be found

原始Flutter Doctor输出：

[√] Flutter (Channel stable, 2.5.3, on Microsoft Windows [Version 10.0.19042.631], locale en-US)
[!] Android toolchain - develop for Android devices (Android SDK version 31.0.0)
! Some Android licenses not accepted.  To resolve this, run: flutter doctor --android-licenses
[√] Chrome - develop for the web
[√] Android Studio (version 2020.3)
[√] Connected device (3 available)
! Doctor found issues in 1 category.

修复步骤 #

• 第一步：修复Pub缓存异常
  1. 进入项目根目录，打开终端执行flutter clean清理项目构建缓存
  2. 执行flutter pub cache repair，工具会自动校验所有缓存的Pub包，补全缺失的文件
  3. 若修复失败，可执行flutter pub cache clean清空全部Pub缓存，再回到项目目录执行flutter pub get重新拉取所有依赖
• 第二步：修复Pub全局路径配置（如第一步未生效可执行）
  1. 打开Windows系统环境变量配置面板，检查用户变量/系统变量中是否存在PUB_CACHE变量
  2. 若存在该变量，将变量值修改为新用户目录下的缓存路径，格式为C:\Users\你的新用户名\AppData\Local\Pub\Cache
  3. 保存配置后重启Android Studio和终端窗口
• 第三步：修复Google SignIn异常
  1. 打开项目下android/key.properties文件，检查签名keystore的存储路径是否仍使用旧的用户名路径，修改为新路径后保存
  2. 重新构建项目即可恢复Google SignIn功能
• 可选修复（解决Flutter Doctor警告）
  终端执行flutter doctor --android-licenses，根据提示输入y同意全部Android许可协议即可消除警告。

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