Micronaut原生Docker镜像端口转发异常求助：应用启动无响应

已知环境与配置 #

• 应用配置（application.properties）：

  micronaut.server.port=${PORT}
  

• Docker启动命令片段：

  -p 8080:8080 --name ss-334 -e PORT=8080
  

• 镜像为GraalVM原生镜像，启动耗时20ms，启动后外部请求无响应

排查步骤 #

1. 验证容器内应用监听状态
   进入容器执行端口监听检查命令（若原生镜像无ss/netstat，可尝试lsof -i :8080），确认应用是否实际绑定了8080端口，以及绑定的地址是否为0.0.0.0而非localhost。

2. 检查Micronaut地址绑定配置
   Micronaut默认仅绑定localhost，容器外部无法访问该地址。需确认配置中是否指定了监听所有网卡：
   查看启动日志（docker logs ss-334），若日志显示Server running on http://localhost:8080，则地址绑定是核心问题。

3. 验证端口转发有效性
   在宿主机执行curl http://localhost:8080或telnet localhost 8080，若宿主机无法连通，说明容器内应用未正确暴露端口/地址；若宿主机能连通但外部无法访问，需检查宿主机防火墙/网络策略。

4. 确认原生镜像构建配置
   检查构建脚本（build.gradle/pom.xml）中的原生镜像任务，确保未遗漏网络相关配置，且环境变量PORT能被正确解析。

解决方案 #

核心修复：修改地址绑定配置 #

在application.properties中添加主机绑定配置，确保应用监听所有网卡地址：

micronaut.server.port=${PORT:8080}
micronaut.server.host=0.0.0.0

• ${PORT:8080}为环境变量设置默认值，避免未传入PORT时启动失败
• 0.0.0.0让应用监听容器内所有网卡，外部可通过端口转发访问

临时替代方案（无需修改配置） #

启动容器时通过环境变量直接覆盖主机配置：

docker run -p 8080:8080 --name ss-334 -e PORT=8080 -e MICRONAUT_SERVER_HOST=0.0.0.0 <你的镜像名>

重新构建镜像并启动容器后，测试外部访问即可恢复正常。

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