DevFixPro

Java Fix, Crash & Optimization Guide

Fix common Java JDK, JAVA_HOME and OutOfMemory errors, with real install, version-compatibility and JVM performance tuning steps.

📅 Updated 2026-08-05✍️ DevFixPro Team✅ Verified 2026-08🧮 Linked tool: Dev RAM Calculator

Java Fix, Crash & Optimization Guide

Java is a widely deployed, JVM-based language used for enterprise backends, Android, and large systems. This guide covers JDK setup, the JAVA_HOME/version pitfalls, and JVM performance tuning developers face most.

Install / First Setup

  • SDKMAN (macOS/Linux, recommended): sdk install java then sdk default java <version>.
  • Debian/Ubuntu: sudo apt install openjdk-17-jdk
  • macOS: brew install openjdk@17, then symlink into /Library/Java/JavaVirtualMachines if needed.
  • Windows: winget install EclipseAdoptium.Temurin.17 (Adoptium/Temurin OpenJDK).

Verify with java -version and javac -version.

Common Issues & Fixes

JAVA_HOME is not set / points at a JRE, not a JDK

Cause: Build tools (Maven/Gradle) need JAVA_HOME to locate the JDK, and it's missing or wrong. Fix: Set it to your JDK root. macOS: export JAVA_HOME=$(/usr/libexec/java_home). Linux: export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64. Windows: set the system variable JAVA_HOME to C:\Program Files\Eclipse Adoptium\jdk-17... and add %JAVA_HOME%\bin to PATH.

java: command not found

Cause: The JDK bin directory is not on PATH. Fix: Add $JAVA_HOME/bin (Linux/macOS) or %JAVA_HOME%\bin (Windows) to PATH, then reopen the terminal.

UnsupportedClassVersionError (major.minor version mismatch)

Cause: You compiled with a newer JDK than the runtime JRE, or vice versa. Fix: Run on a JDK/JRE at or above the compiled version, or recompile targeting the runtime: javac --release 17 MyApp.java. Match source/target in Maven/Gradle to your runtime.

java.lang.OutOfMemoryError

Cause: The JVM heap (-Xmx) is too small for the workload, or there's a genuine leak. Fix: Raise the max heap, e.g. java -Xmx2g -jar app.jar. For 32 GB+ machines use -Xmx8g or more. If it persists at higher limits, profile for a memory leak rather than just raising the cap.

Multiple JDKs conflict (javac vs java differ)

Cause: Several JDKs installed; PATH/JAVA_HOME resolve to different ones. Fix: On Linux use sudo update-alternatives --config java (and javac). With SDKMAN, sdk default java <version> pins the active one. Keep JAVA_HOME and PATH consistent.

Performance & Optimization

  • Low-End (2–4 GB): Set a modest heap, e.g. java -Xms256m -Xmx1g, and keep -Xmx below physical RAM. G1GC is the modern default and self-tunes.
  • Mid (8–16 GB): java -Xms2g -Xmx8g -XX:+UseG1GC -jar app.jar. Tune young-gen only if profiling shows GC pressure.
  • Workstation (32 GB+): Larger heaps (-Xmx16g+) reduce GC frequency; consider -XX:+UseZGC or -XX:+UseShenandoahGC for low-latency workloads. Always measure with a profiler (VisualVM, JFR) before changing collectors.

General: the JVM JIT compiles hot methods at runtime, so short benchmarks mislead — warm up before measuring.

Version & Compatibility Notes

  • Long-Term Support (LTS) releases are Java 8, 11, 17, and 21. Non-LTS releases (e.g. 9–10, 12–16, 18–20) are supported only briefly.
  • Java 8 remains common in legacy systems; new projects should target 17 or 21 LTS.
  • "Java" can mean Oracle JDK or OpenJDK builds (Temurin, Corretto, Zulu) — they are largely compatible; licensing differs.
  • For exact version/EOL details, consult official release notes.

FAQ

Q: What is JAVA_HOME and do I need it? A: JAVA_HOME tells build tools where the JDK is. You need it for Maven, Gradle, and most app servers. Point it at a JDK, not just a JRE.

Q: JDK vs JRE — which should I install? A: Install a JDK; it includes the JRE plus javac and dev tools. Running only prebuilt apps needs just a JRE, but development requires the JDK.

Q: How do I switch Java versions? A: Use SDKMAN (sdk default java <v>) on macOS/Linux, or update-alternatives --config java on Debian/Ubuntu. On Windows, adjust JAVA_HOME and PATH.

Q: How much heap should I give the JVM? A: Start at about 25–50% of RAM and tune from there with -Xmx. Leave enough for the OS and off-heap memory. Measure GC behavior rather than maxing it out.

Q: Why does my jar fail with UnsupportedClassVersionError? A: It was compiled for a newer Java than your runtime. Either run on a newer JRE or recompile with javac --release <your-runtime> (or set maven.compiler.release).

Q: Is Oracle JDK free to use? A: OpenJDK builds (Temurin, Corretto, etc.) are free for most uses. Oracle JDK has specific licensing terms — check Oracle's current license for production use.

Related Guides

Accuracy Note

Commands and paths reflect common, real-world setups as of 2026-08. Always verify against your installed version and OS. When in doubt, consult the official Java documentation.

Calculator Recommended Adjustment Params

Run the Dev RAM Calculator with the values referenced in this guide to validate your rig before and after the fix.