启动Ktor服务器时出现LinuxWatchService函数未实现异常

异常信息 #

Exception in thread "main" java.io.IOException: 功能未实现
       at java.base/sun.nio.fs.LinuxWatchService.<init>(LinuxWatchService.java:64)
       at java.base/sun.nio.fs.LinuxFileSystem.newWatchService(LinuxFileSystem.java:47)
       at io.ktor.server.engine.ApplicationEngineEnvironmentReloading$watcher$2.invoke(ApplicationEngineEnvironmentReloading.kt:81)
       at io.ktor.server.engine.ApplicationEngineEnvironmentReloading$watcher$2.invoke(ApplicationEngineEnvironmentReloading.kt:79)
       at kotlin.SynchronizedLazyImpl.getValue(LazyJVM.kt:74)
       at io.ktor.server.engine.ApplicationEngineEnvironmentReloading.getWatcher(ApplicationEngineEnvironmentReloading.kt:79)
       at io.ktor.server.engine.ApplicationEngineEnvironmentReloading.cleanupWatcher(ApplicationEngineEnvironmentReloading.kt:364)
       at io.ktor.server.engine.ApplicationEngineEnvironmentReloading.start(ApplicationEngineEnvironmentReloading.kt:281)
       at io.ktor.server.netty.NettyApplicationEngine.start(NettyApplicationEngine.kt:216)
       at io.ktor.server.netty.EngineMain.main(EngineMain.kt:23)

问题原因 #

该异常源于Ktor的自动重载功能依赖Java WatchService，但当前Linux环境（如WSL1、部分容器或受限系统）不支持该服务，导致初始化失败。

解决办法 #

1. 配置文件中禁用自动重载

在application.conf（或application.yaml）中添加以下配置，清空监听路径以关闭重载：

ktor {
    deployment {
        watch = []
    }
}

2. 代码层面关闭重载

若通过代码手动构建应用环境，直接设置空的监听路径：

val environment = applicationEngineEnvironment {
    // 保留其他原有配置
    watchPaths = emptyList()
}

3. 通过JVM参数禁用

使用Gradle或Maven运行时，添加JVM参数强制关闭WatchService：

• Gradle：修改build.gradle.kts中的run任务

tasks.withType<JavaExec> {
    jvmArgs("-Dio.ktor.deployment.watch=false")
}

• Maven：在exec-maven-plugin中配置参数

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <configuration>
        <arguments>
            <argument>-Dio.ktor.deployment.watch=false</argument>
        </arguments>
    </configuration>
</plugin>

内容的提问来源于stack exchange，提问作者HPage