Windows端Android Studio搭配WSL2项目/JDK同步报错求助

问题根源 #

WSL2环境下的JDK会将Windows格式路径（如C:\AndroidStudio\plugins\android\lib\android.jar）判定为非法URI——冒号在URI的opaque部分属于违规字符。而Windows端Android Studio会把本地插件路径以Windows格式传递给WSL中的Gradle，直接触发解析错误。

解决步骤 #

1. 配置Gradle转换Windows路径为WSL格式 #

在项目根目录的gradle.properties中添加以下配置，将Windows路径映射为WSL可识别的挂载路径：

systemProp.android.sdkRoot=/mnt/c/AndroidStudio/sdk
systemProp.android.plugin.path=/mnt/c/AndroidStudio/plugins/android/lib

注意替换为你实际Android Studio安装目录对应的WSL路径（Windows的C:\对应WSL的/mnt/c/）。

2. 检查Android Studio的WSL集成设置 #

• 打开Settings → Build, Execution, Deployment → Build Tools → Gradle
• Gradle JDK选择WSL中的Oracle OpenJDK（路径类似\\wsl$\openSUSE-Tumbleweed\usr/lib/jvm/java-18-openjdk）
• Gradle user home设置为WSL内的目录，比如\\wsl$\openSUSE-Tumbleweed\home\你的用户名\.gradle

3. 修改项目Build脚本的插件路径 #

在项目根目录的build.gradle（Project级别）中，将classpath里的Android插件路径替换为WSL挂载路径：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath files('/mnt/c/AndroidStudio/plugins/android/lib/android.jar')
        classpath 'com.android.tools.build:gradle:8.0.1'
    }
}

4. 验证WSL路径有效性 #

在WSL终端执行以下命令，确认路径存在：

ls /mnt/c/AndroidStudio/plugins/android/lib/android.jar

能返回文件信息则说明路径映射正常。

5. 清理缓存重启 #

执行File → Invalidate Caches...，勾选Clear file system cache and local history后重启Android Studio，再尝试同步项目。

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