为什么要把 SpringBoot 放进 Docker？

说实话，hen多小伙伴在本地用 IDEA 启动项目时感觉hen爽，却总是担心「跑得通」的代码在服务器上会蹦跶。Docker 的出现正好给了我们一个统一的运行环境：一次打包，处处可用。再配合 Alpine、JDK‑Slim 等轻量镜像，成本几乎Ke以忽略不计。

SpringBoot 本身依赖 Java 8+，所以确保系统里Yi经装好 JDK和 Maven。 java -versionmvn -v 两条命令Nengkan到版本信息就说明没问题。

Ru果你使用的是 Ubuntu 系统，只需要执行：

sudo apt-get update
sudo apt-get install -y docker.io
sudo usermod -aG docker $USER   # 加入 docker 组后重新登录
docker version

Windows/macOS 用户直接下载 Docker Desktop 即可。

下面用 Maven 的原型命令创建一个叫 learn-server-app 的项目：

mvn archetype:generate \
    -DarchetypeGroupId=org.springframework.boot \
    -DarchetypeArtifactId=spring-boot-sample-simple-archetype \
    -DarchetypeVersion=2.7.5 \
    -DgroupId=com.example \
    -DartifactId=learn-server-app \
    -Dversion=0.0.1-SNAPSHOT \
    -Dpackage=com.example.learnserver \
    -B

进入目录后用 IDE 打开，随手在 MainApplication.java 中加上一段健康检查的接口：

@RestController
public class HealthController {
    @GetMapping
    public String ok { return "I am alive!"; }
}

多阶段构建Ke以让我们只保留运行时必需的文件，而把 Maven、源码等臃肿的东西全部丢掉。

# -------- Stage 1: 编译 --------
FROM maven:3.9-eclipse-temurin-17-alpine AS builder
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn -B package -DskipTests
# -------- Stage 2: 运行 --------
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
# 把 Stage1 打好的 jar 拷进来
COPY --from=builder /app/target/*.jar app.jar
# 设置时区、随机数源，提高容器启动速度
ENV TZ=Asia/Shanghai \
    JAVA_OPTS="-Djava.security.egd=file:/dev/./urandom"
EXPOSE 8080
ENTRYPOINT 

温馨提示：这里的 -Djava.security.egd=file:/dev/./urandom Neng让 SpringBoot 在容器里启动geng快，尤其是第一次热身时。

# 在项目根目录执行
docker build -t springboot-learn:0.1 . 
# 查kan是否成功
docker images | grep springboot-learn

Ru果你想把镜像推到私有仓库，只需要在前面加上仓库地址，例如 myrepo.com/springboot-learn:0.1, 然后：

# 登录仓库
docker login myrepo.com
# 推送镜像
docker push myrepo.com/springboot-learn:0.1

# 将宿主机 10010 端口映射到容器内部的 8080，并为容器起个名字
docker run -d --name learn-server \
   -p 10010:8080 \
   springboot-learn:0.1 

SprintBoot 默认把日志写到 /logs/app.log。我们Ke以把这个路径映射到宿主机的持久化目录：

# 假设宿主机Yi有 /opt/learn-logs 文件夹
docker run -d --name learn-server \
   -p 10010:8080 \
   -v /opt/learn-logs:/app/logs \
   springboot-learn:0.1 

*这样即使容器死掉，日志依旧保存在宿主机上，不会随容器一起消失。

# 在 Dockerfile Zui后一行追加：
HEALTHCHECK --interval=30s --timeout=5s \ 
  CMD curl -f http://localhost:8080/health || exit 1

有了这行指令后docker ps --filter "status=healthy" 就Neng快速定位状态良好的实例。

Poor memory limit：K8s 或者手工 run 时Ru果没有显式指定内存上限，JVM 会尝试使用宿主机全部内存，引发 OOM。建议加上 -Xmx256m/-XX:+UnlockExperimentalVMOptions –XX:+UseCGroupMemoryLimitForHeap.

CORS 跨域报错：SprintBoot 默认不允许跨域请求，在前端调试时经常遇到“Access-Control‑Allow‑Origin”错误。只需在控制器或全局添加 @CrossOrigin.

Dockerfile 缓存失效：Maven 下载依赖是耗时操作。Ru果你每次改动源码dou重新走完整个构建，会hen慢。Ke以把 COPY pom.xml . && RUN mvn dependency:go-offline 提前写在前面这样只有 pom 有变化才会重新下载。

Liveness vs Readiness：K8s 环境下两者区别大。Ru果只写了 health 检查，却没有 readiness 探针，服务可Neng被流量提前路由进去导致错误响应。记得同时配置两种探针。

Apm配合 SpringBoot Actuator 暴露指标，再通过 Docker‑compose 或 Kubernetes Service 暴露给外部抓取；日志则Ke以使用 ELK Stack，把挂载出来的文件统一收集。

K8s Deployment Ke以声明滚动geng新策略，只要镜像 tag 改成新版本，然后执行 . 容器会一台台替换，下线前先检查 health，使业务几乎不受影响。