Docker构建Ktor后端失败：gradle命令退出码1问题排查

我尝试用Docker容器运行Ktor后端，但执行docker compose up时失败，报错：

failed to solve: process "/bin/sh -c gradle installDist --no-daemon" did not complete successfully: exit code: 1

对应的Dockerfile如下：

#FROM ubuntu:latest
#LABEL authors="Joy"
#
#ENTRYPOINT ["top", "-b"]

# Build stage: Using Gradle with JDK 21
FROM gradle:8.6-jdk21 AS build

# Set working directory
WORKDIR /app

# Copy Gradle configuration files
COPY gradle ./gradle

# This is done before copying the source code to leverage Docker's layer caching
COPY build.gradle.kts settings.gradle.kts gradle.properties ./

# Copy the source code
COPY src ./src

# Build the application
# The --no-daemon flag ensures Gradle doesn't start a background process
RUN gradle installDist --no-daemon
#RUN gradle build

# Runtime stage: Corretto is a no-cost, production-ready distribution of the Open Java Development Kit (OpenJDK).
FROM amazoncorretto

# Set working directory
WORKDIR /app

# Copy the built application from the build stage
COPY --from=build /app/build/install/ ./

# Expose the port that Ktor will use (adjust according to your configuration)
EXPOSE 8080

# Define the port environment variable (can be used in your Ktor configuration)
ENV PORT=8080

# Command to run the application
CMD ["app/bin/app"]

我试过将RUN gradle installDist --no-daemon替换为RUN gradle build，但依旧报错，请问该命令执行失败的原因是什么？

可能的失败原因及排查方向： #

• 依赖下载失败：Gradle构建容器无法访问Maven仓库（网络受限、未配置国内镜像源等），导致依赖拉取超时或失败。可在build.gradle.kts中添加国内镜像源，或检查容器网络是否正常。
• 项目本身编译错误：先在本地执行gradle installDist确认项目能正常构建，如果本地也失败，说明是源码、依赖配置或语法问题，优先修复本地构建问题。
• 权限问题：Gradle镜像默认使用gradle用户执行命令，若复制到容器的文件权限异常（如只读），会导致构建失败。可在COPY源码后添加RUN chown -R gradle:gradle /app修正权限。
• Gradle配置不兼容：检查build.gradle.kts中Ktor插件版本是否支持JDK21，Gradle任务配置是否正确（比如installDist任务是否正确定义）。
• Docker缓存冲突：旧的缓存层可能导致依赖或代码不一致，执行docker builder prune清理缓存后，再用docker compose up --build重新构建。

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