How to Quickly Debug Java Applications Remotely with IDEA

In real development, some issues only appear in pre‑release or production environments and cannot be reproduced locally, making debugging time‑consuming. Enabling Java remote debugging provides a simple and efficient way to locate such problems.

Overall Process for Enabling Java Remote Debugging

1. Upload the JAR to the Linux server.

2. Start the service with remote‑debug options.

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar test-1.0-SNAPSHOT.jar

The above command enables remote debugging on port 5005.

3. Configure remote debugging in IDEA.

In IDEA, create a “Remote” configuration and set the host and port (e.g., 5005).

4. Launch the remote debugger.

5. Test the remote debug session.

Visit http://ip:port/jvm/test1; the breakpoint will be hit in the local IDE.

After debugging, stop the session.

Key Points

Ensure the local code version matches the server version.

Use remote debugging only in test or pre‑release environments; avoid production unless no other options exist, as it blocks other user requests.

Remote debugging adds network overhead and may affect performance.

A stable network connection between the debugger and the Java application is required.