WSL中通过WSLENV传递含空格的JAVA_HOME路径时Gradle报错

问题场景 #

我在Windows系统中设置了JAVA_HOME环境变量：

PS > Get-Item Env:JAVA_HOME   

Name                           Value
----                           -----
JAVA_HOME                      C:\Program Files\Eclipse Adoptium\jdk-11.0.15.10-hotspot

配置WSLENV向WSL/Ubuntu共享该变量：

$env:WSLENV="JAVA_HOME/p"

验证路径已完成格式转换：

$ env | grep JAVA
JAVA_HOME=/mnt/c/Program Files/Eclipse Adoptium/jdk-11.0.15.10-hotspot

手动加引号可以cd进入该目录，但运行Gradle时却报错：

[gradle] ERROR: JAVA_HOME is set to an invalid directory: /mnt/c/Program Files/Eclipse Adoptium/jdk-11.0.15.10-hotspot

确定问题出在路径空格，但不清楚如何让系统自动处理引号？WSLENV的/p参数不是应该解决这个问题吗？在Windows中给环境变量加引号也没有效果。

解决方案 #

1. 在WSL中重新定义JAVA_HOME
   直接在WSL的shell配置文件（比如~/.bashrc或~/.zshrc）中添加转义后的路径：

   # 方式一：用双引号包裹路径
   export JAVA_HOME="/mnt/c/Program Files/Eclipse Adoptium/jdk-11.0.15.10-hotspot"
   # 方式二：用反斜杠转义空格
   export JAVA_HOME=/mnt/c/Program\ Files/Eclipse\ Adoptium/jdk-11.0.15.10-hotspot
   

   保存后执行source ~/.bashrc（对应你的shell配置文件）使设置生效。

2. 关于WSLENV的/p参数
   /p参数仅负责Windows路径到WSL路径的格式转换（比如将C:\转换为/mnt/c/），但不会自动处理路径中的空格转义。环境变量传递时是原始字符串，WSL不会主动给带空格的路径添加引号或转义符。

3. Windows中加引号无效的原因
   在Windows环境变量中给路径加引号，传递到WSL时引号会被包含在环境变量值中，导致JAVA_HOME变成"/mnt/c/Program Files/..."，Gradle会把引号当成路径的一部分，自然识别为无效目录。

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