Skip to content

開發模式

Ktor 提供了一種專門針對開發的特殊模式。此模式啟用了以下功能:

  • 用於在不重新啟動伺服器的情況下重新載入應用程式類別的 Auto-reload了解如何使用自動重新載入功能,在程式碼變更時重新載入應用程式類別。。
  • 用於偵錯管線的延伸資訊(包含堆疊追蹤)。
  • 發生 5** 伺服器錯誤時,在 回應頁面StatusPages 允許 Ktor 應用程式根據擲出的例外或狀態碼,對任何失敗狀態做出適當的回應。上顯示延伸的偵錯資訊。

請注意,開發模式會影響效能,不應在生產環境中使用。

啟用開發模式

您可以透過不同的方式啟用開發模式:在應用程式配置檔案中、使用專用的系統屬性或環境變數。

配置檔案

若要在 配置檔案了解如何在組態檔案中配置各種伺服器參數。中啟用開發模式,請將 development 選項設為 true:

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

'io.ktor.development' 系統屬性

io.ktor.development 系統屬性允許您在執行應用程式時啟用開發模式。

若要使用 IntelliJ IDEA 在開發模式下執行應用程式,請將 io.ktor.development 搭配 -D 旗標傳遞給 虛擬機選項:

-Dio.ktor.development=true

如果您使用 Gradle了解如何將 Ktor Server 相依性新增至現有的 Gradle/Maven 專案。 任務執行應用程式,可以透過以下兩種方式之一啟用開發模式:

  • 在您的 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' 環境變數

若要為 原生用戶端啟用開發模式,請使用 io.ktor.development 環境變數。