Micronaut项目Jenkins构建Docker镜像COPY文件不存在错误如何解决？

问题根因 #

你遇到的报错核心原因是构建阶段执行完成后，/app/build/layers目录未生成，导致多阶段构建的COPY步骤找不到对应路径。本地构建正常但Jenkins构建失败，通常是环境配置差异导致的，可按以下步骤排查解决：

排查步骤 #

1. 先确认build目录下是否真的没有layers产物，在Dockerfile的build阶段添加目录打印命令：

FROM gradle:7.2.0-jdk16 as build
WORKDIR /app
COPY --chown=gradle:gradle . /app
RUN gradle build --no-daemon
# 新增这行打印build目录结构，Jenkins构建日志中可以看到输出
RUN ls -la /app/build

如果日志中确实没有layers目录，按照以下方案修复。

解决方案 #

方案1：启用Micronaut分层构建特性 #

Micronaut默认不开启分层jar构建，需要在项目的build.gradle（Groovy语法）中添加配置：

micronaut {
    runtime("netty")
    // 启用分层构建，生成layers目录
    layered {
        enabled = true
    }
}

如果是Kotlin DSL的build.gradle.kts，配置如下：

micronaut {
    runtime("netty")
    layered {
        enabled.set(true)
    }
}

同时建议将Dockerfile中的构建命令替换为RUN gradle assemble --no-daemon，确保分层产物完整生成。

方案2：不使用分层构建，直接修改Dockerfile的COPY逻辑 #

如果不需要分层构建优化镜像构建速度，可以直接去掉分层相关的COPY步骤，改为直接复制构建好的jar包：

FROM openjdk:16-alpine
WORKDIR /home/app
# 直接复制所有jar包重命名为application.jar
COPY --from=build /app/build/libs/*.jar /home/app/application.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/home/app/application.jar"]

额外排查：Jenkins权限问题 #

如果把gradle构建移到Jenkinsfile中执行仍报错，需要确认Jenkins执行用户对backend目录有读写权限，可在Jenkins构建阶段添加以下步骤确认产物是否生成：

stage('Check build product') {
    steps {
        dir('backend') {
            sh 'chmod -R 755 build'
            sh 'ls -la build'
        }
    }
}

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