WSL2中java -version报错是因JDK路径未加入PATH，需将/usr/lib/jvm/java-17-openjdk-amd64/bin添加至~/.bashrc并source；跨系统调用需用wsl -e或/mnt/c/路径；编码问题导致NoClassDefFoundError应统一为UTF-8；网络访问需配置0.0.0.0绑定并检查Windows防火墙。
WSL2里装JDK为什么java -version还是报错？
常见现象是：在WSL2终端里执行sudo apt install openjdk-17-jdk成功，但java -version提示Command 'java' not found。根本原因不是没装上，而是/usr/lib/jvm/下的JDK没被加进$PATH——Ubuntu系默认只把/usr/bin加进去了，而OpenJDK的java二进制实际在/usr/lib/jvm/java-17-openjdk-amd64/bin/这类路径下。
- 执行
sudo update-alternatives --config java确认当前选中的JDK路径 - 用
readlink -f $(which java)反查真实位置（如果which能查到） - 把对应
bin目录加进~/.bashrc或~/.zshrc：export PATH="/usr/lib/jvm/java-17-openjdk-amd64/bin:$PATH" - 别忘了
source ~/.bashrc重载配置
Windows和WSL2之间Java路径怎么互通？
你不能直接在WSL2里运行C:\Program Files\Java\jdk-17\bin\java.exe，因为那是Windows可执行文件，Linux内核不认；反过来，Windows命令行也跑不了WSL2里的/usr/bin/java。想跨系统调用，得靠WSL2的互操作机制：
- 从Windows调用WSL2 Java：用
wsl -e java -version，注意-e后必须跟完整命令，不能带管道或重定向 - 从WSL2访问Windows文件里的
.jar：路径要转成/mnt/c/Users/xxx/app.jar，但别指望java -jar /mnt/c/...总能成功——Windows NTFS权限、换行符、路径空格都可能让JVM加载失败 - IDEA或VS Code远程开发时，务必在WSL2侧配置
JAVA_HOME指向Linux路径（如/usr/lib/jvm/java-17-openjdk-amd64），而不是Windows路径
javac编译正常但java运行报NoClassDefFoundError
这通常不是classpath问题，而是WSL2里Java默认用的是UTF-8编码，但某些Windows生成的源码文件用了GBK或UTF-8 with BOM，javac能忍，java类加载器却会在解析常量池时出错。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 用
file -i YourClass.java检查文件编码，如果是charset=iso-8859-1或含bom，就重存为纯utf-8 - 强制编译时指定编码：
javac -encoding UTF-8 YourClass.java - 避免在Windows记事本里写Java源码——它默认保存为
ANSI（即本地GBK），且不提示 - 如果用Maven，确保
pom.xml里有<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
WSL2 Java进程为什么监听不到localhost:8080？
WSL2有自己的虚拟网络，localhost在WSL2里指向它自己的loopback，不是Windows宿主机。所以Spring Boot启动后显示Started Application in X seconds (JVM running for Y)，但Windows浏览器打不开http://localhost:8080。
立即学习“Java免费学习笔记（深入）”；
- 改用
0.0.0.0:8080启动服务（如java -Dserver.address=0.0.0.0 -jar app.jar），并确认应用配置了server.port=8080且未绑定127.0.0.1 - Windows侧用
http://localhost:8080能访问的前提是：WSL2的端口已自动映射（Win11 22H2+默认开启，旧版需手动启用echo 1 | sudo tee /proc/sys/net/ipv4/ip_forward并配置iptables） - 如果仍不行，先在WSL2里
curl http://localhost:8080确认服务真在跑，再在Windows PowerShell里telnet localhost 8080看端口是否通
最常被忽略的一点：WSL2的防火墙规则不继承Windows防火墙，但Windows防火墙会拦截来自WSL2的入站连接——如果开了“专用网络”防火墙，得手动放行java.exe或对应端口。
