Skip to content

開發模式

Ktor 提供了一種專為開發而設的特殊模式。此模式啟用以下功能:

  • Auto-reload
    瞭解如何使用 Auto-reload 在程式碼變更時重新載入應用程式類別。
    用於在不重新啟動伺服器的情況下重新載入應用程式類別。
  • 用於偵錯管線的擴展資訊(附帶堆疊追蹤)。
  • 當發生 5** 伺服器錯誤時,在
    回應頁面
    %plugin_name% 允許 Ktor 應用程式根據拋出的異常或狀態碼,對任何失敗狀態做出適當的回應。
    上提供擴展偵錯資訊。

NOTE

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

啟用開發模式

您可以透過多種方式啟用開發模式:在應用程式設定檔中、使用專用的系統屬性或環境變數。

設定檔

要在

設定檔
瞭解如何在設定檔中配置各種伺服器參數。
中啟用開發模式, 請將 development 選項設定為 true

yaml

「io.ktor.development」系統屬性

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

若要使用 IntelliJ IDEA 在開發模式下運行應用程式, 請將帶有 -D 標誌的 io.ktor.development 傳遞給 VM 選項

如果您使用

Gradle
瞭解如何將 Ktor 伺服器依賴項新增到現有的 Gradle/Maven 專案中。
任務運行應用程式, 您可以透過兩種方式啟用開發模式:

  • 在您的 build.gradle.kts 檔案中配置 ktor 區塊:

    Kotlin
  • 透過傳遞 Gradle CLI 標誌來啟用單次運行的開發模式:

    bash

TIP

您也可以使用 -ea 標誌啟用開發模式。 請注意,使用 -D 標誌傳遞的 io.ktor.development 系統屬性優先於 -ea

「io.ktor.development」環境變數

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