Dockerfile中RUN mv命令报错：目标路径非目录问题求助

问题原因 #

你执行RUN mv build/libs/Component-Name-?.?.?.jar build/libs/app.jar时触发报错，核心原因是shell通配符?.?.?匹配到了多个文件：mv命令在源为多个文件时，要求目标必须是目录，但你指定的app.jar是文件名，因此触发“目标不是目录”的错误。另外也可能是通配符写法不准确，导致匹配逻辑不符合实际生成的文件。

分步解决方法 #

第一步：先确认实际生成的Jar文件 #

把查看文件列表的命令移到mv之前，先明确build/libs下的真实文件情况，避免通配符写错：

RUN ./gradlew build
RUN ls -l build/libs  # 先输出实际文件，确认Jar名称格式
RUN mv build/libs/Component-Name-*.jar build/libs/app.jar

执行构建后，就能看到是否存在多个Jar（比如带-sources.jar、-javadoc.jar的附属包），以及主Jar的准确命名规则。

第二步：根据文件情况选择修复方式 #

情况1：仅生成一个可执行Jar

如果build/libs下只有一个需要的Jar文件，把通配符改成更通用的*，确保单文件匹配：

RUN mv build/libs/Component-Name-*.jar build/libs/app.jar

这种写法如果仅匹配到单个文件，mv会直接将其重命名为app.jar，不会触发报错。

情况2：生成多个Jar文件

如果存在多个Jar（如源码包、文档包），需要精准匹配主可执行Jar，比如根据后缀规则调整通配符：

# 匹配不带额外后缀的主Jar（如Component-Name-1.0.0.jar）
RUN mv build/libs/Component-Name-[0-9]*.jar build/libs/app.jar
# 如果是Spring Boot的fatJar，通常带-all后缀
RUN mv build/libs/Component-Name-*-all.jar build/libs/app.jar

更优方案：直接在Gradle构建时指定输出Jar名

不用在Docker中做重命名操作，直接在项目的build.gradle（或build.gradle.kts）里配置Jar任务，让构建产物直接叫app.jar：

// 普通Java项目
jar {
    archiveFileName = 'app.jar'
}
// Spring Boot项目（用bootJar任务）
bootJar {
    archiveFileName = 'app.jar'
}

配置后，build/libs下直接生成app.jar，Dockerfile中可直接删除mv命令，简化流程。

额外优化：替换为Gradle镜像 #

你的构建阶段使用Maven镜像但执行Gradle命令，换成官方Gradle镜像更适配，避免环境差异：

FROM gradle:7.6-jdk17 as builder  # 选择与项目匹配的Gradle版本
WORKDIR /app
ARG ARTIFACTORY_USER
ARG ARTIFACTORY_PASSWORD
COPY . .
RUN ./gradlew build

修正后的完整Dockerfile示例 #

采用Gradle镜像+Gradle配置Jar名的方案：

FROM gradle:7.6-jdk17 as builder
WORKDIR /app
ARG ARTIFACTORY_USER
ARG ARTIFACTORY_PASSWORD
COPY . .
RUN ./gradlew build

FROM registry.access.redhat.com/ubi9/openjdk-17-runtime:latest
USER 0
RUN mkdir /app && chown -R 185:0 /app && microdnf update -y

USER 185
WORKDIR /app
COPY --from=builder /app/build/libs/app.jar /app

EXPOSE 8093
ENTRYPOINT ["java", "-jar", "app.jar"]

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