必须安装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 等开发必需组件。

实操建议：

• 从 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 本身问题，而是配置路径错位或权限异常。

实操建议：

• 在 IDEA 的 File → Project Structure → SDKs 页面中，点击 + → Add JDK，**手动选择 JDK 解压后的根目录**（不是 bin 子目录，也不是 jre 子目录）
• 如果使用 Apple Silicon Mac（M1/M2），确认下载的是 aarch64 架构 JDK；混用 x64 JDK 会导致 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。

实操建议：

• 统一源头：在 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 启动参数缺失导致的典型问题。

实操建议：

• 启动容器时加 --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 对齐确认。