推荐优先使用 COPY——它语义明确、行为可预测，仅执行本地文件字节级拷贝，不支持自动解压或 URL 下载；ADD 虽支持解压 tar 和远程下载，但易引发意外覆盖或构建不稳定，仅在确需解压本地归档时使用。
在 Java 项目中构建 Docker 镜像时，COPY 和 ADD 都能将本地 JAR 包复制进镜像，但推荐优先使用 COPY —— 它语义明确、行为可预测，且不带隐式解压或远程下载等副作用。
明确区分 COPY 与 ADD 的适用场景
COPY 是纯复制指令：只把宿主机文件/目录按路径原样拷贝到镜像指定位置，不处理压缩包、不拉取 URL。适合绝大多数 Java 构建场景，比如把打包好的 app.jar 放进镜像。
ADD 功能更多（支持自动解压 tar 包、从 URL 下载），但也因此容易引发意外行为：比如误把 app.jar 当作 tar 解压（实际不会，但逻辑上不安全），或因网络问题导致构建失败。除非真需要解压本地 tar 或下载远程资源，否则没必要用 ADD。
正确写法：COPY JAR 到镜像并设置运行入口
假设你的 Maven 项目构建后生成 target/myapp-1.0.0.jar，Dockerfile 应这样写：
立即学习“Java免费学习笔记（深入）”；
- 确保
jar文件已存在本地（即先执行mvn clean package） - 在 Dockerfile 中用
COPY显式指定源路径（相对构建上下文）和目标路径（镜像内绝对路径） - 用
ENTRYPOINT或CMD启动 JAR，注意指定 JVM 参数和主类（若 MANIFEST.MF 已定义 Main-Class，可省略-jar后的类名）
示例：
FROM openjdk:17-jre-slim WORKDIR /app COPY target/myapp-1.0.0.jar app.jar ENTRYPOINT ["java", "-Xms256m", "-Xmx512m", "-jar", "app.jar"]
避免常见错误
构建失败或运行报错，往往源于这几个细节：
-
路径错误：COPY 源路径是相对于
docker build命令所在目录（即构建上下文），不是相对于 Dockerfile 所在目录。建议把 Dockerfile 放在项目根目录，然后运行docker build -t myapp . - JAR 未生成就构建：Docker 构建不感知 Maven 生命周期。必须手动先构建 JAR，或用多阶段构建（见下一点）
-
权限或启动失败：JAR 没有可执行权限不影响 Java 运行；但若提示
no main manifest attribute，说明 MANIFEST.MF 缺失 Main-Class，需检查maven-jar-plugin或spring-boot-maven-plugin配置
进阶建议：用多阶段构建自动编译（无需提前打包）
如果想让构建过程更自动化、不依赖本地 target/ 目录，可用多阶段构建：
FROM maven:3.8-openjdk-17 AS builder WORKDIR /app COPY pom.xml . RUN mvn dependency:go-offline COPY . . RUN mvn package -DskipTests FROM openjdk:17-jre-slim WORKDIR /app COPY --from=builder /app/target/myapp-*.jar app.jar ENTRYPOINT ["java", "-jar", "app.jar"]
这样整个构建流程由 Docker 独立完成，JAR 在中间阶段生成，再 COPY 到最终运行镜像，干净且可重现。
