Skip to content

개발 모드

Ktor는 개발을 위해 특화된 특별한 모드를 제공합니다. 이 모드를 사용하면 다음과 같은 기능들을 활용할 수 있습니다.

  • 서버를 재시작하지 않고 애플리케이션 클래스를 다시 로드하기 위한 자동 리로드(Auto-reload)코드 변경 시 애플리케이션 클래스를 다시 로드하기 위해 오토 리로드(Auto-reload)를 사용하는 방법을 알아봅니다..
  • 파이프라인(pipelines) 디버깅을 위한 확장 정보(스택 트레이스 포함).
  • 5** 서버 오류가 발생한 경우 응답 페이지(response page)StatusPages 플러그인을 사용하면 Ktor 애플리케이션이 발생한 예외나 상태 코드를 기반으로 모든 실패 상태에 적절히 응답할 수 있습니다.에 표시되는 확장 디버깅 정보.

개발 모드는 성능에 영향을 미치므로 운영 환경(production)에서는 사용해서는 안 됩니다.

개발 모드 활성화하기

애플리케이션 설정 파일, 전용 시스템 속성 또는 환경 변수를 사용하는 등 다양한 방법으로 개발 모드를 활성화할 수 있습니다.

설정 파일

설정 파일설정 파일에서 다양한 서버 파라미터를 구성하는 방법을 알아봅니다.에서 개발 모드를 활성화하려면 development 옵션을 true로 설정하세요.

ktor {
    development = true
}
yaml
ktor:
    development: true

'io.ktor.development' 시스템 속성

io.ktor.development 시스템 속성을 사용하면 애플리케이션을 실행할 때 개발 모드를 활성화할 수 있습니다.

IntelliJ IDEA를 사용하여 애플리케이션을 개발 모드로 실행하려면, -D 플래그와 함께 io.ktor.development를 VM 옵션에 전달하세요.

-Dio.ktor.development=true

Gradle기존 Gradle/Maven 프로젝트에 Ktor 서버 의존성을 추가하는 방법을 알아봅니다. 태스크를 사용하여 애플리케이션을 실행하는 경우, 다음 두 가지 방법 중 하나로 개발 모드를 활성화할 수 있습니다.

  • build.gradle.kts 파일의 ktor 블록을 구성합니다.

    kotlin
    ktor {
        development = true
    }
  • Gradle CLI 플래그를 전달하여 단일 실행에 대해 개발 모드를 활성화합니다.

    bash
    ./gradlew run -Pio.ktor.development=true

-ea 플래그를 사용하여 개발 모드를 활성화할 수도 있습니다. 단, -D 플래그로 전달된 io.ktor.development 시스템 속성이 -ea보다 우선순위를 가집니다.

'io.ktor.development' 환경 변수

네이티브 클라이언트(Native client)의 개발 모드를 활성화하려면 io.ktor.development 환경 변수를 사용하세요.