Docker运行Scala应用：本地无法访问映射端口的端点

我在Docker容器中运行Scala应用，执行了以下操作：

• 构建镜像：docker build -t myapp:latest .
• 启动容器：docker run -d -p 8081:8081 --name myapp app:latest

我能通过docker exec -it <container hash> bash进入容器，在容器终端里执行curl --request GET http://localhost:8081能正常访问端点并得到预期响应，但在本地机器上执行相同命令却无法访问。

我已检查本地端口配置，代码里也指定了8081端口，但docker ps显示没有运行中的容器，这和容器内能正常访问的情况矛盾。

1. 确认容器真实状态

   • 执行docker ps -a查看所有容器（包括已停止的），确认myapp容器的状态。如果docker ps无显示但能exec进入，大概率是容器处于异常运行状态，或是你进入的是其他同名/同哈希的容器。
   • 执行docker inspect <container hash>查看容器的运行状态、端口映射、网络配置等信息，确认8081端口是否完成正确映射。

2. 修正容器启动的镜像名错误
   你构建的镜像是myapp:latest，但启动容器时用的是app:latest，这会导致Docker拉取不存在的镜像（本地无该镜像时），启动的容器和你构建的Scala应用无关。修正启动命令：

   docker run -d -p 8081:8081 --name myapp myapp:latest
   

3. 检查Scala应用的绑定地址
   容器内能访问但本地不能，最常见原因是应用绑定了127.0.0.1而非0.0.0.0，导致仅能接受容器内部请求：

   • 若用Play框架，在application.conf中设置：play.server.http.address="0.0.0.0"，同时指定端口play.server.http.port=8081
   • 若用Akka HTTP，绑定端点时指定地址：Http().bindAndHandle(routes, "0.0.0.0", 8081)

4. 验证端口映射与本地网络

   • Linux/macOS执行netstat -tulpn | grep 8081，Windows执行netstat -ano | findstr :8081，确认本地8081端口是否被Docker占用。
   • 若端口被其他程序占用，更换映射端口，比如-p 8082:8081，之后本地用curl http://localhost:8082测试访问。

5. 重启容器重新验证

   • 先清理异常容器：docker stop myapp && docker rm myapp
   • 用修正后的命令重新启动容器：docker run -d -p 8081:8081 --name myapp myapp:latest
   • 执行docker ps确认容器处于Up状态，再在本地执行curl http://localhost:8081测试。

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