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 运行应用程序时开启开发模式,请将带有 -D 标志的 io.ktor.development 传递给 VM 选项:

-Dio.ktor.development=true

如果您使用 Gradle了解如何向现有的 Gradle/Maven 项目中添加 Ktor Server 依赖项。 任务运行应用程序,可以通过以下两种方式之一启用开发模式:

  • 在您的 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 环境变量。