使用Jib构建SpringBoot Docker镜像后端口绑定失败问题

核心原因 #

Jib Maven插件中<container>下的<ports>配置，仅作用于Docker镜像的EXPOSE元数据——它只是告诉Docker容器内的应用监听这个端口，但不会自动将容器端口绑定到主机端口，这就是Docker Desktop显示8080/tcp未绑定的直接原因。

解决方法 #

1. 运行容器时手动指定端口映射（推荐）

这是Docker的标准实践，端口映射属于运行时配置，而非镜像构建时的固定绑定。执行以下命令启动容器，将主机80端口映射到容器内的8080端口：

docker run -p 80:8080 <你的镜像名称:标签>

之后直接访问http://localhost即可访问Spring Boot应用。如果主机80端口被占用，可换用其他端口（比如8080）：

docker run -p 8080:8080 <你的镜像名称:标签>

此时访问http://localhost:8080即可。

2. 构建镜像时预设端口映射（不推荐）

如果希望构建镜像时就包含端口发布的默认配置（不符合Docker镜像可复用的最佳实践），可以在Jib插件中添加extraDirectives配置：

<plugin>
  <groupId>com.google.cloud.tools</groupId>
  <artifactId>jib-maven-plugin</artifactId>
  <version>你的Jib版本号</version>
  <configuration>
    <container>
      <ports>
        <port>8080</port>
      </ports>
      <extraDirectives>
        <run>
          <publish>8080</publish>
        </run>
      </extraDirectives>
    </container>
  </configuration>
</plugin>

构建后启动容器时，需加上-P参数触发预设的发布配置：

docker run -P <你的镜像名称:标签>

Docker会自动将容器8080端口映射到主机随机端口，可通过docker ps查看具体映射的主机端口。

额外检查点 #

• 确认Spring Boot应用在容器内正常监听8080端口：进入容器执行curl localhost:8080，或查看应用日志是否有Tomcat started on port(s): 8080的输出。
• 检查主机端口占用情况：Mac上执行lsof -i :80查看80端口是否被其他服务占用，如有则更换主机端口。

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