開發模式

開發模式

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

• 用於在不重新啟動伺服器的情況下重新載入應用程式類別的
  Auto-reload

  了解如何使用 Auto-reload 在程式碼變更時重新載入應用程式類別。
  。
• 用於偵錯管線的延伸資訊（包含堆疊追蹤）。
• 發生 5** 伺服器錯誤時，在
  回應頁面

  %plugin_name% 允許 Ktor 應用程式根據擲出的例外狀況或狀態碼，對任何失敗狀態做出適當的回應。
  上顯示延伸的偵錯資訊。

NOTE

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

啟用開發模式

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

配置檔案

若要在

配置檔案

了解如何在配置檔案中配置各種伺服器參數。

中啟用開發模式，請將 development 選項設為 true：

application.confapplication.yaml

'io.ktor.development' 系統屬性

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

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

如果您使用

Gradle

了解如何將 Ktor Server 相依性新增至現有的 Gradle/Maven 專案。

任務執行應用程式，可以透過以下兩種方式之一啟用開發模式：

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

• 透過傳遞 Gradle CLI 旗標來為單次執行啟用開發模式：

TIP

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

'io.ktor.development' 環境變數

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