必须安装JDK而非JRE，因JRE不含javac、tools.jar等开发组件；需正确配置JAVA_HOME与PATH，IDE中手动指定JDK根目录，注意架构匹配、权限及Gradle/CI/Docker环境一致性。
Java开发环境必须装JDK而不是JRE
只装 JRE 会导致 javac 命令不存在、IDE 报 “No SDK configured”、Maven 编译直接失败。JRE 只含运行时，JDK 才带编译器、调试器和 tools.jar 等开发必需组件。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 从 Eclipse Temurin 或 Amazon Corretto 下载 JDK（推荐 LTS 版本，如
jdk-17.0.1+12），避开 Oracle JDK 的商用授权风险 - Windows 用户务必检查系统环境变量：
JAVA_HOME指向 JDK 根目录（如C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12），且%JAVA_HOME%\bin在PATH前置位置 - macOS/Linux 用户用
export JAVA_HOME=$(/usr/libexec/java_home -v 17)动态定位，避免硬编码路径
IntelliJ IDEA 中识别不到JDK的常见原因
即使 java -version 和 javac -version 都正常，IDEA 仍可能报 “Cannot determine path to ‘tools.jar’” 或 “SDK is not valid” —— 这通常不是 JDK 本身问题，而是配置路径错位或权限异常。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在 IDEA 的
File → Project Structure → SDKs页面中，点击+→Add JDK，**手动选择 JDK 解压后的根目录**（不是bin子目录，也不是jre子目录） - 如果使用 Apple Silicon Mac（M1/M2），确认下载的是
aarch64架构 JDK；混用x64JDK 会导致 IDEA 启动卡死或 SDK 校验失败 - 某些国产杀毒软件会拦截
tools.jar加载，临时禁用后重试；也可在Help → Diagnostic Tools → Debug Log Settings中添加#com.intellij.openapi.projectRoots.impl.SdkConfigurationUtil查看加载日志
Gradle项目里JAVA_HOME和gradle.properties冲突
Gradle 默认优先读取 gradle.properties 中的 org.gradle.java.home，若该值与系统 JAVA_HOME 不一致，会出现编译输出字节码版本不符（如提示 Unsupported class file major version 61），或测试阶段 ClassNotFoundException。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 统一源头：在
gradle.properties中显式设置org.gradle.java.home=/path/to/your/jdk-17，**不要留空或注释掉它** - 验证方式：执行
./gradlew --version，观察输出中JVM:行是否匹配预期 JDK 路径和版本 - CI 场景下（如 GitHub Actions），避免依赖全局
JAVA_HOME，改用actions/setup-java@v4并指定java-version和distribution，防止因 runner 镜像预装 JDK 导致版本漂移
Docker容器内Java进程无法被jstack/jmap连接
本地能用 jstack 查线程堆栈，但进到容器里执行相同命令却报 Unable to get pid of LinuxThreads manager thread 或 No such process —— 这是容器 PID namespace 隔离 + JVM 启动参数缺失导致的典型问题。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 启动容器时加
--cap-add=SYS_PTRACE，否则jstack/jmap因权限不足无法 attach 到目标进程 - JVM 启动参数中加入
-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0，让 JVM 正确感知容器内存限制，避免 OOM Killer 杀进程 - 调试镜像建议基于
eclipse-temurin:17-jdk-jammy（而非-jre版），确保$JAVA_HOME/bin下有完整诊断工具链
虚拟机里搭 Java 环境最易被忽略的点，其实是 JDK 安装包类型和宿主机架构的严格匹配 —— x86_64 的 JDK 在 ARM64 的虚拟机里根本跑不起来，但错误提示往往藏在 java -version 的静默失败或 SIGILL 信号里，得靠 file $(which java) 和 uname -m 对齐确认。
