IntelliJ IDEA를 사용하여 코루틴 디버그하기 – 튜토리얼

이 튜토리얼은 Kotlin 코루틴을 생성하고 IntelliJ IDEA를 사용하여 디버그하는 방법을 보여줍니다.

이 튜토리얼은 코루틴 개념에 대한 사전 지식이 있다고 가정합니다.

코루틴 생성

1. IntelliJ IDEA에서 Kotlin 프로젝트를 엽니다. 프로젝트가 없다면, 프로젝트를 생성하세요.

2. Gradle 프로젝트에서 kotlinx.coroutines 라이브러리를 사용하려면, build.gradle(.kts)에 다음 의존성을 추가하세요:

    dependencies {
        implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
    }
    ```
```groovy [Groovy]
    dependencies {
        implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2'
    }
    ```
:::

    다른 빌드 시스템의 경우, [`kotlinx.coroutines` README](https://github.com/Kotlin/kotlinx.coroutines#using-in-your-projects)에서 지침을 확인하세요.

3.  `src/main/kotlin` 디렉터리에 있는 `Main.kt` 파일을 엽니다.

    `src` 디렉터리에는 Kotlin 소스 파일과 리소스가 포함되어 있습니다. `Main.kt` 파일에는 `Hello World!`를 출력할 샘플 코드가 들어 있습니다.

4.  `main()` 함수에서 코드를 변경합니다:

    *   [`runBlocking()`](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/run-blocking.html) 블록을 사용하여 코루틴을 감싸세요.
    *   [`async()`](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/async.html) 함수를 사용하여 지연된 값 `a`와 `b`를 계산하는 코루틴을 생성하세요.
    *   [`await()`](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-deferred/await.html) 함수를 사용하여 계산 결과를 기다리세요.
    *   [`println()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.io/println.html) 함수를 사용하여 계산 상태와 곱셈 결과를 출력하세요.

    ```kotlin
    import kotlinx.coroutines.*
    
    fun main() = runBlocking<Unit> {
        val a = async {
            println("I'm computing part of the answer")
            6
        }
        val b = async {
            println("I'm computing another part of the answer")
            7
        }
        println("The answer is ${a.await() * b.await()}")
    }
    ```

5.  **Build Project**를 클릭하여 코드를 빌드합니다.

    ![Build an application](flow-build-project.png)

## 코루틴 디버그

1.  `println()` 함수 호출이 있는 줄에 중단점(breakpoint)을 설정합니다:

    ![Build a console application](coroutine-breakpoint.png)

2.  화면 상단의 실행 구성 옆에 있는 **Debug**를 클릭하여 코드를 디버그 모드로 실행합니다.

    ![Build a console application](flow-debug-project.png)

    **Debug** 도구 창이 나타납니다:
    *   **Frames** 탭에는 호출 스택이 포함되어 있습니다.
    *   **Variables** 탭에는 현재 컨텍스트의 변수들이 포함되어 있습니다.
    *   **Coroutines** 탭에는 실행 중이거나 일시 중단된(suspended) 코루틴에 대한 정보가 포함되어 있습니다. 여기에는 세 개의 코루틴이 표시됩니다.
    첫 번째 코루틴은 **RUNNING** 상태이고, 나머지 두 코루틴은 **CREATED** 상태입니다.

    ![Debug the coroutine](coroutine-debug-1.png)

3.  **Debug** 도구 창에서 **Resume Program**을 클릭하여 디버거 세션을 재개합니다:

    ![Debug the coroutine](coroutine-debug-2.png)

    이제 **Coroutines** 탭에 다음이 표시됩니다:
    *   첫 번째 코루틴은 **SUSPENDED** 상태입니다 – 값을 곱할 수 있도록 값을 기다리고 있습니다.
    *   두 번째 코루틴은 `a` 값을 계산 중이며 – **RUNNING** 상태입니다.
    *   세 번째 코루틴은 **CREATED** 상태이며 `b` 값을 계산하고 있지 않습니다.

4.  **Debug** 도구 창에서 **Resume Program**을 클릭하여 디버거 세션을 재개합니다:

    ![Build a console application](coroutine-debug-3.png)

    이제 **Coroutines** 탭에 다음이 표시됩니다:
    *   첫 번째 코루틴은 **SUSPENDED** 상태입니다 – 값을 곱할 수 있도록 값을 기다리고 있습니다.
    *   두 번째 코루틴은 값을 계산하고 사라졌습니다.
    *   세 번째 코루틴은 `b` 값을 계산 중이며 – **RUNNING** 상태입니다.

IntelliJ IDEA 디버거를 사용하면 각 코루틴을 더 깊이 탐색하여 코드를 디버그할 수 있습니다.

### 최적화되어 사라진 변수

`suspend` 함수를 사용하는 경우, 디버거에서 변수 이름 옆에 "was optimized out"이라는 텍스트가 표시될 수 있습니다:

![Variable "a" was optimized out](variable-optimised-out.png){width=480}

이 텍스트는 변수의 수명이 단축되어 변수가 더 이상 존재하지 않음을 의미합니다.
최적화된 변수가 있는 코드는 해당 값을 볼 수 없기 때문에 디버그하기 어렵습니다.
`-Xdebug` 컴파일러 옵션을 사용하여 이 동작을 비활성화할 수 있습니다.

::: warning

__경고: 이 플래그를 프로덕션 환경에서 절대 사용하지 마세요__: `-Xdebug`는 [메모리 누수](https://youtrack.jetbrains.com/issue/KT-48678/Coroutine-debugger-disable-was-optimised-out-compiler-feature#focus=Comments-27-6015585.0-0)를 유발할 수 있습니다.

:::