HTTP 요청 생명주기
필요한 의존성: io.ktor:ktor-server-core
코드 예제: server-http-request-lifecycle
지원되는 엔진: Netty, CIO
Native 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✖️
기본적으로 Ktor는 클라이언트와의 연결이 끊어지더라도 요청 처리를 계속 진행합니다. HttpRequestLifecycle 플러그인을 사용하면 클라이언트 연결이 끊어지는 즉시 요청 처리를 취소할 수 있습니다.
이는 클라이언트가 더 이상 응답을 기다리지 않을 때 실행을 중단해야 하는, 오래 실행되거나 리소스를 많이 소모하는 요청을 처리할 때 유용합니다.
HttpRequestLifecycle 설치 및 구성
HttpRequestLifecycle 플러그인을 활성화하려면 install 함수를 사용하여 애플리케이션 모듈에 설치하고 cancelCallOnClose 프로퍼티를 설정합니다.
import io.ktor.server.application.*
import io.ktor.server.http.HttpRequestLifecycle
fun Application.module() {
install(HttpRequestLifecycle) {
cancelCallOnClose = true
}
}cancelCallOnClose 프로퍼티가 활성화되면 HttpRequestLifecycle 플러그인은 요청별로 취소 핸들러를 등록합니다. 클라이언트 연결이 끊어지면 해당 특정 라우트를 처리하는 코루틴만 취소됩니다.
취소는 구조화된 동시성(structured concurrency)을 통해 전파되므로, 요청 코루틴에서 시작된 모든 자식 코루틴(예: launch 또는 async 사용)도 함께 취소됩니다. 다음 중단 지점(suspension point)에서 CancellationException이 발생합니다.
취소 처리
리소스 해제나 백그라운드 작업 중단과 같은 정리(cleanup) 작업을 수행하기 위해 CancellationException을 캐치할 수 있습니다.
fun Application.module() {
install(HttpRequestLifecycle) {
cancelCallOnClose = true
}
routing {
get("/long-process") {
try {
while (isActive) {
delay(10_000)
log.info("Very important work.")
}
call.respond("Completed")
} catch (e: CancellationException) {
log.info("Cleaning up resources.")
}
}
}
}코루틴 취소는 협동적(cooperative)입니다. 블로킹 코드나 CPU 바운드 코드는 자동으로 중단되지 않습니다. 요청 처리에서 장시간 실행되는 작업을 수행하는 경우, 취소에 반응할 수 있도록 call.coroutineContext.ensureActive()를 호출하세요.
자세한 내용은 코루틴 취소(Coroutine cancellation)를 참조하세요.
전체 예제는 server-http-request-lifecycle에서 확인할 수 있습니다.
제한 사항
이 플러그인은 CIO 및 Netty 엔진에서만 온전히 지원됩니다. 서블릿 기반 엔진(또는 지원되지 않는 기타 엔진)은 클라이언트 연결 해제를 안정적으로 감지할 수 없습니다. 취소는 서버가 응답 쓰기를 시도할 때만 감지될 수 있습니다.
