From 9695e0a9d158f13438dddb08d3df80ceffca039a Mon Sep 17 00:00:00 2001 From: Andy Wilkinson Date: Tue, 17 Jan 2017 14:43:38 +0000 Subject: [PATCH] Document breakpoint config for remote debug tunnel and IntelliJ IDEA Closes gh-7732 See gh-5047 --- .../src/main/asciidoc/using-spring-boot.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/spring-boot-docs/src/main/asciidoc/using-spring-boot.adoc b/spring-boot-docs/src/main/asciidoc/using-spring-boot.adoc index 16d2639939..4d538f111a 100644 --- a/spring-boot-docs/src/main/asciidoc/using-spring-boot.adoc +++ b/spring-boot-docs/src/main/asciidoc/using-spring-boot.adoc @@ -1117,6 +1117,15 @@ increase timeouts in your IDE. For example, in Eclipse you can select `Java` -> from `Preferences...` and change the `Debugger timeout (ms)` to a more suitable value (`60000` works well in most situations). +WARNING: When using the remote debug tunnel with IntelliJ IDEA, all breakpoints must be +configured to suspend the thread rather than the VM. By default, breakpoints in IntelliJ +IDEA suspend the entire VM rather than only suspending the thread that hit the +breakpoint. This has the unwanted side-effect of suspending the thread that manages the +remote debug tunnel, causing your debugging session to freeze. When using the remote +debug tunnel with IntelliJ IDEA, all breakpoints should be configured to suspend the +thread rather than the VM. Please set +https://youtrack.jetbrains.com/issue/IDEA-165769[IDEA-165769] for further details. + [[using-boot-packaging-for-production]]