Skip to content

开发模式

Ktor 提供了一种专门用于开发的模式。此模式支持以下功能:

  • 自动重载
    了解如何使用自动重载在代码更改时重新加载应用程序类。
    ,用于在不重启服务器的情况下重新加载应用程序类。
  • 用于调试 管道 的扩展信息(附带堆栈跟踪)。
  • 在发生 5** 服务器错误时,在
    响应页面
    %plugin_name% 允许 Ktor 应用程序根据抛出的异常或状态码适当地响应任何失败状态。
    上显示扩展调试信息。

NOTE

请注意,开发模式会影响性能,不应在生产环境中使用。

启用开发模式

您可以通过多种方式启用开发模式:在应用程序配置文件中、使用专用系统属性或环境变量。

配置文件

要在

配置文件
了解如何在配置文件中配置各种服务器参数。
中启用开发模式, 请将 development 选项设置为 true

yaml

'io.ktor.development' 系统属性

io.ktor.development系统属性 允许您在运行应用程序时启用开发模式。

要在 IntelliJ IDEA 中使用开发模式运行应用程序, 请将带有 -D 标志的 io.ktor.development 传递给 VM options

如果您使用

Gradle
了解如何将 Ktor 服务器依赖项添加到现有 Gradle/Maven 项目。
任务运行应用程序, 可以通过两种方式启用开发模式:

  • 在您的 build.gradle.kts 文件中配置 ktor 块:

    Kotlin
  • 通过传递 Gradle CLI 标志,为单次运行启用开发模式:

    bash

TIP

您还可以使用 -ea 标志来启用开发模式。 请注意,通过 -D 标志传递的 io.ktor.development 系统属性优先于 -ea

'io.ktor.development' 环境变量

要为 原生客户端 启用开发模式, 请使用 io.ktor.development 环境变量。