最新2025：解决java.lang.IllegalArgumentException: this and base files have different roots

bug说明

[ksp] java.lang.IllegalArgumentException: this and base files have different roots: ……
at kotlin.io.FilesKt__UtilsKt.toRelativeString(Utils.kt:117)
at kotlin.io.FilesKt__UtilsKt.relativeTo(Utils.kt:128)

背景：解决Android studio kotlin项目bug
原因：Android gradle包缓存和项目不在同一个盘中

解决方案

.android

1. 首先新建一个文件夹，用于存放修改路径后的. android 文件夹。我选择的路径为 D:\Android\AVDs
2. 新建一个系统的环境变量，变量名为 ANDROID_SDK_HOME。变量值即为上一步的路径。如下图所示。

3. 将 “C:\Users \ 用户名” 目录下的. android 文件夹剪切到 “D:\Android\AVDs” 目录下。（担心有风险的话，可以提前做好备份）
4. 修改 D:\Android\AVDs.android\avd 中的. ini 文件，将 path 中原来的 “C:\Users \ 用户名” 路径修改为当前路径。如下图所示。
   注意：所有. ini 文件都要修改，一个. ini 文件对应一个设备

5. 重启电脑生效。

.gradle

1. 找到 C:\Users \ 用户名.gradle，将其移动到项目所在盘任意目录
2. 打开 Android Studio，File -> Settings。直接修改成你希望设置的缓存路径即可。
   
3. 重启 Android Studio，重新运行项目，即可解决