容器内Gradle持续构建+Ktor自动重载无法检测文件变更

问题背景 #

使用Ktor开发API服务器，通过Docker容器化运行，已配置以下文件实现基础运行：

Dockerfile #

FROM debian:bullseye-slim

RUN apt-get update && apt-get install -y --no-install-recommends openjdk-17-jdk bash && rm -rf /var/lib/apt/lists/*

WORKDIR /backend

CMD ["./gradlew", "run"]

docker-compose.yml #

version:  "3.8"

services:
  ktor-backend:
    build: ./
    container_name: company-backend
    volumes:
      - ./:/backend
    ports:
      - "8080:8080"
    expose:
      - 8080
    environment:
      - url=${pg_url}
      - username=${pg_username}
      - password=${pg_password}

执行docker-compose up --build后可正常访问API，日志显示应用监听目录变更。但进入容器执行./gradlew -t installDist设置持续构建后，修改宿主机Routing.kt文件，容器卷中文件已同步，却未触发重建。

应用配置与代码 #

HOCON配置：

ktor {
    development = true
    deployment {
        port = 8080
        port = ${?PORT}
        autoreload = true
    }
    application {
        modules = [ app.joblink.ApplicationKt.module ]
    }
}

Application.kt代码：

fun Application.module() {
    configureSecurity()
    configureHTTP()
    configureSerialization()
    configureDatabases()
    configureRouting()
}

fun main(args: Array<String>) {
    embeddedServer(
        Netty,
        watchPaths = listOf("backend","classes"),
        module = Application::module
    ).start(true)
    println("test")
}

原因分析 #

• Gradle任务目标与Ktor热重载路径不匹配
  你执行的./gradlew -t installDist是将构建产物打包到build/install目录，但Ktor的watchPaths监听的是backend和classes，该任务的输出目录不在监听范围内。而且./gradlew run本身就支持自动构建重启，无需额外执行installDist的持续构建。

• Windows与Linux容器的文件系统通知兼容性问题
  Windows主机挂载卷到Linux容器时，容器内的文件系统事件（如inotify）无法正确接收Windows侧的文件变更通知，直接导致Gradle的文件监听失效，无法触发自动构建。

• Ktor热重载路径配置错误
  Ktor的watchPaths配置的backend是相对路径，容器内工作目录为/backend，实际源码在/backend/src，编译后的类文件在/backend/build/classes/kotlin/main，当前监听的路径未覆盖这些关键目录，自然无法触发重载。

• 并行Gradle任务冲突
  你同时运行了docker-compose up启动的./gradlew run和手动执行的./gradlew -t installDist，两个并行的Gradle任务会导致文件锁冲突或构建输出被覆盖，干扰自动构建的触发逻辑。

解决建议 #

• 直接使用./gradlew run -t替代单独执行installDist持续构建，run任务本身会监听源码变更并自动重启应用。
• 调整Ktor的watchPaths为容器内的正确路径：listOf("src", "build/classes/kotlin/main")，确保覆盖源码和编译产物目录。
• 针对Windows环境，改用WSL2作为Docker后端，或在Gradle配置中添加org.gradle.vfs.watch=true来优化文件系统通知兼容性。
• 避免同时运行多个Gradle构建任务，只保留一个负责自动构建的任务。

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