Micronaut测试中如何注入未知可用服务器端口至应用配置？

我们的测试有时会失败，原因是启动Embedded Server时手动选择的端口已被占用。目前通过SocketUtils.findAvailableTcpPort()获取端口并配置服务URL，但在繁忙的构建服务器上失败率约5%，根源是端口竞争。我们想知道能否通过注入属性的方式，利用Micronaut的随机端口功能来避免这个问题。

现有客户端加载模式：

@Requires(property = "micronaut.http.services.some-service.url")

当前测试代码（Kotlin）：

val port: Int = SocketUtils.findAvailableTcpPort()
val applicationProperties: Map<String, Any> = 
    mapOf(
        "micronaut.server.port" to port,
        "micronaut.http.services.some-service.url" to "http://localhost:$port"
    )
val embeddedServer = ApplicationContext.run(
    EmbeddedServer::class.java, 
    applicationProperties, 
    "test"
 )

解决方案 #

1. 直接使用Micronaut随机端口占位符配置 #

Micronaut支持用${micronaut.server.port}占位符引用服务器端口，同时设置micronaut.server.port=-1即可让框架自动分配可用端口（无需手动检查端口，避免时间窗口竞争）。

方式一：代码内配置

修改测试代码，去掉手动端口查找逻辑：

val applicationProperties: Map<String, Any> = 
    mapOf(
        "micronaut.server.port" to -1, // 指定使用随机端口
        "micronaut.http.services.some-service.url" to "http://localhost:${micronaut.server.port}"
    )
val embeddedServer = ApplicationContext.run(
    EmbeddedServer::class.java, 
    applicationProperties, 
    "test"
 )
// 若需获取实际绑定的端口，可通过embeddedServer.port获取

方式二：测试配置文件配置

在src/test/resources/application-test.yml中添加配置：

micronaut:
  server:
    port: -1 # 启用随机端口
  http:
    services:
      some-service:
        url: "http://localhost:${micronaut.server.port}"

测试代码简化为：

val embeddedServer = ApplicationContext.run(EmbeddedServer::class.java, "test")

2. 结合@MicronautTest注解（单元测试场景） #

如果是编写单元测试，使用@MicronautTest注解会自动启动带随机端口的嵌入式服务器，配合配置文件中的占位符，客户端会自动指向正确的地址：

@MicronautTest
class SomeControllerTest {

    @Inject
    lateinit var embeddedServer: EmbeddedServer

    @Inject
    lateinit var someClient: SomeClient // 自动使用配置的some-service.url

    @Test
    fun testControllerEndpoint() {
        // 测试逻辑，可通过embeddedServer.port获取实际端口
    }
}

为什么这个方案能解决端口竞争？ #

手动用SocketUtils.findAvailableTcpPort()只是检查端口当前可用，但从检查完成到Micronaut绑定端口之间存在时间窗口，在繁忙服务器上可能被其他进程抢占。而Micronaut的随机端口机制是直接让操作系统分配可用端口，跳过手动检查环节，完全避免了端口竞争问题。

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