Docker运行SpringBoot容器报错：mvnw不在$PATH中如何解决？

原因分析 #

错误提示表明系统在$PATH中找不到mvnw可执行文件，核心原因有两个：

1. 直接使用mvnw命令时，容器默认$PATH不包含当前工作目录（/app），系统无法定位到该文件
2. 从Windows系统复制到容器的mvnw文件，可能丢失了Linux系统要求的执行权限

解决方案 #

方案1：指定mvnw的相对路径 #

修改Dockerfile中的CMD指令，明确指定当前目录下的mvnw（已设置WORKDIR /app，相对路径有效）：

CMD [ "./mvnw", "spring-boot:run" ]

方案2：添加执行权限 #

如果mvnw没有执行权限，即使路径正确也无法运行，在Dockerfile中添加权限设置：
在COPY mvnw pom.xml ./之后新增一行：

RUN chmod +x mvnw

完整修改后的Dockerfile：

# syntax=docker/dockerfile:1
FROM openjdk:oraclelinux8
WORKDIR /app
COPY .mvn/ .mvn
COPY mvnw pom.xml ./
RUN chmod +x mvnw
RUN ./mvnw dependency:go-offline
COPY src ./src
CMD [ "./mvnw", "spring-boot:run" ]

方案3：多阶段构建（推荐） #

上述方式在容器中直接运行maven命令，镜像体积大且运行效率低。更优的方式是先构建可执行jar包，再用轻量Java镜像运行：

# 构建阶段：生成jar包
FROM maven:3.8.6-openjdk-11 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段：启动jar包
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/target/*.jar app.jar
CMD [ "java", "-jar", "app.jar" ]

这种方式镜像体积更小，运行时无需maven环境，符合Docker最佳实践。

验证步骤 #

1. 重新构建镜像：docker build -t donhuvy/springboot-docker:v1.0.1 .
2. 运行容器：docker run donhuvy/springboot-docker:v1.0.1

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ