Ktor+Gradle环境下JUnit5注解测试函数无法执行问题

Ktor的embeddedServer默认启动时会阻塞当前线程，而@BeforeAll是在JUnit的主线程中执行的。一旦主线程被服务器启动逻辑卡住，JUnit完全无法推进到@BeforeEach、@Test等后续生命周期步骤，导致服务器一直运行但测试根本没机会执行。

1. 异步启动服务器，避免阻塞主线程 #

在@BeforeAll中启动服务器时，调用start(wait = false)，这个参数会让服务器在后台启动，不会阻塞当前线程，JUnit就能继续执行后续测试逻辑。

2. 测试完成后主动关闭服务器 #

在@AfterAll中调用服务器实例的stop()方法，确保测试结束后服务器能正常关闭，不会一直占用端口。

完整测试代码示例 #

import io.ktor.client.HttpClient
import io.ktor.client.call.body
import io.ktor.client.request.get
import io.ktor.http.HttpStatusCode
import io.ktor.server.application.Application
import io.ktor.server.application.install
import io.ktor.server.engine.embeddedServer
import io.ktor.server.netty.Netty
import io.ktor.server.plugins.contentnegotiation.ContentNegotiation
import io.ktor.server.response.respondText
import io.ktor.server.routing.get
import io.ktor.server.routing.routing
import kotlinx.coroutines.runBlocking
import org.junit.jupiter.api.AfterAll
import org.junit.jupiter.api.BeforeAll
import org.junit.jupiter.api.Test
import kotlin.test.assertEquals

class RealServerTest {
    companion object {
        private lateinit var server: io.ktor.server.engine.ApplicationEngine

        @BeforeAll
        @JvmStatic
        fun startServer() {
            // 用0让系统分配随机端口，避免端口冲突
            server = embeddedServer(Netty, port = 0) {
                install(ContentNegotiation)
                routing {
                    get("/hello") {
                        call.respondText("Hello World!")
                    }
                }
            }.start(wait = false) // 关键：异步启动，不阻塞线程
        }

        @AfterAll
        @JvmStatic
        fun stopServer() {
            server.stop(1000, 5000) // 等待1秒停止接受新请求，5秒内处理完现有请求
        }
    }

    private val client = HttpClient()

    @Test
    fun testHelloEndpoint() = runBlocking {
        val port = server.resolvedConnectors().first().port
        val response = client.get("http://localhost:$port/hello")
        assertEquals(HttpStatusCode.OK, response.status)
        assertEquals("Hello World!", response.body<String>())
    }
}

额外注意事项 #

• 用随机端口（port=0）可以避免本地开发环境中端口被占用的问题，测试时通过server.resolvedConnectors().first().port获取实际使用的端口
• 测试中的HTTP请求要用Ktor的HttpClient，确保和服务器的通信逻辑匹配
• 确认Gradle依赖中已正确引入JUnit 5和Ktor测试相关依赖，比如：

  dependencies {
      testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
      testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.0")
      testImplementation("io.ktor:ktor-client-core:2.3.3")
      testImplementation("io.ktor:ktor-client-cio:2.3.3")
      testImplementation("io.ktor:ktor-server-tests:2.3.3")
  }
  

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