云服务器配Java失败主因是环境变量未生效、安全组/防火墙拦截、JDK版本与字节码不兼容；应统一配置/etc/profile.d/java.sh、放行云安全组端口、校验JAVA_HOME/PATH/which java一致、按项目需求匹配JDK版本。
java -version 报错或返回空，基本不是“没装Java”，而是环境变量没生效、路径写错、或用户权限隔离导致的——这是云服务器配 Java 最高频的假性失败。
PATH 和 JAVA_HOME 配错位置，改了也白改
很多人在 ~/.bashrc 里加了 JAVA_HOME 和 PATH，但用 sudo su 切换到 root 后发现 java 找不到。原因：不同用户 shell 配置文件独立，root 不读普通用户的 ~/.bashrc；而 /etc/profile 是全局生效，但只对登录 shell（如 SSH 登录）有效，systemd 服务或后台脚本默认不加载它。
- 推荐做法：统一写入
/etc/profile.d/java.sh（新建文件），内容为：export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH
- 然后执行
source /etc/profile.d/java.sh立即生效，且所有用户、所有 shell 类型（包括非登录 shell）都能继承 - 验证命令别只跑
java -version，还要跑echo $JAVA_HOME和which java，三者必须指向同一路径
OpenJDK 版本和应用不兼容，尤其老项目踩得最深
很多 Spring Boot 2.2+ 项目要求 JDK 11+，但你装了 openjdk-17-jdk，结果 Tomcat 启动报 UnsupportedClassVersionError ——这不是版本太高，反而是编译目标版本（-target）低于运行时 JDK 的最小支持值。更常见的是：项目用 JDK 8 编译，却部署到 JDK 17，没加 --illegal-access=permit 或模块参数，直接卡在类加载阶段。
- 查清项目编译 JDK：看
pom.xml中maven-compiler-plugin的source/target，或用javap -v YourClass.class | grep version - 云服务器上不要盲目装最新版；Ubuntu/Debian 推荐用
sudo apt install openjdk-11-jdk（稳定、免依赖冲突）；CentOS/RHEL 用yum install java-11-openjdk-devel - 若必须多版本共存，用
update-alternatives --config java切换，别手动改软链
远程调试连不上，90% 是端口没通透
本地 IDE 配了 Remote JVM Debug，填了服务器公网 IP 和 5005，但一直显示 “Connection refused”。你以为是防火墙或参数错了，其实根本没走到那一步——云服务商（阿里云/腾讯云/AWS）的安全组默认屏蔽所有非 22 端口，5005 根本没放行。
- 必须两步都做：① 服务器本地开防火墙端口（如
ufw allow 5005）；② 进云控制台 → 安全组 → 添加入方向规则：协议TCP / 端口5005 / 来源0.0.0.0/0（或限定你的办公IP） - 启动命令别漏
address=*:5005（JDK 8/11 写法），否则默认绑定127.0.0.1，外部连不了：java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jar
- 调试完立刻关掉端口，生产环境严禁长期开放调试端口
Tomcat 启动成功但访问 8080 超时，别只盯 Java
ps -ef | grep tomcat 显示进程在跑，netstat -tuln | grep :8080 也看到监听，但浏览器打不开——这往往不是 Java 或 Tomcat 的问题，而是云服务器的「内网 IP 绑定」或「SELinux 干预」。
立即学习“Java免费学习笔记（深入）”；
- 检查
$CATALINA_HOME/conf/server.xml中Connector的address属性：若写死为127.0.0.1或内网 IP（如172.18.0.3），需改成0.0.0.0或删掉该属性（默认监听所有接口） - CentOS 7+/Alibaba Cloud Linux 默认启用 SELinux，会拦截非标准端口网络行为，临时关闭验证：
setenforce 0；永久关闭需改/etc/selinux/config - 确认 Tomcat 日志
logs/catalina.out末尾无SEVERE错误；有则优先排查日志，不是先改配置
command not found。 
