COPY指令是构建Java应用Docker镜像时复制JAR包的最常用方式，需确保JAR位于构建上下文内、路径准确、分层合理，并配合轻量JRE基础镜像与正确ENTRYPOINT设置。
构建 Java 应用的 Docker 镜像时，COPY 指令是最常用、最直接的方式将本地编译好的 JAR 包复制进镜像。关键在于路径准确、分层合理、避免冗余文件。
确保 JAR 包已生成并位于构建上下文内
Docker 构建时只能访问 构建上下文（build context）目录及其子目录 中的文件。因此，Maven 或 Gradle 打包生成的 JAR 文件（如 target/app.jar 或 build/libs/app-1.0.jar）必须放在 Dockerfile 所在目录的可访问路径下。
- 推荐做法：在项目根目录执行
mvn clean package，再运行docker build -t myapp . - 不推荐：把
Dockerfile放在src/下，却试图 COPY../target/app.jar—— 构建会失败，因为上级目录不在上下文中
COPY 指令写法要简洁明确
COPY 不支持通配符展开（如 COPY target/*.jar /app.jar），也不自动解压或重命名。需指定确切源路径和目标路径。
- 正确示例：
COPY target/myapp-0.1.0.jar /app.jar - 若 JAR 名含版本号且常变，可用 Maven 的
finalName固定名称，或配合.dockerignore过滤掉其他文件，减少上下文体积 - 目标路径建议用绝对路径（如
/app.jar），避免因工作目录变化导致路径错误
结合基础镜像与运行环境优化
Java 应用只需 JRE 运行，无需完整 JDK。选用 slim 或 jre 标签的基础镜像更轻量：
立即学习“Java免费学习笔记（深入）”；
-
FROM openjdk:17-jre-slim—— 推荐，体积小、安全更新及时 -
COPY后应设置启动命令：ENTRYPOINT ["java", "-jar", "/app.jar"] - 如需传参（如配置文件、JVM 参数），用
ENTRYPOINT+CMD组合，例如：ENTRYPOINT ["java", "-jar", "/app.jar"]CMD ["--spring.profiles.active=prod"]
避免常见陷阱
COPY 看似简单，但几个细节容易引发运行失败：
- JAR 包权限问题：Linux 容器中默认无执行权限，但
java -jar不依赖文件执行位，只要可读即可；无需RUN chmod +x - 时间戳与缓存：Docker 构建会缓存
COPY步骤。若 JAR 内容变了但文件名未变（如 snapshot 版本），可能误用旧缓存 —— 可加--no-cache或在COPY前加RUN rm -f /app.jar强制刷新 - 不要 COPY 整个
target/目录：包含测试类、临时文件等，增大镜像且存在安全风险
