子目录执行 docker build . 会失败，因为 Docker 默认仅上传当前目录及其子目录作为构建上下文，导致根目录的 Dockerfile、pom.xml 等关键文件不可见，引发“Cannot locate specified Dockerfile”或依赖缺失错误。
不能直接在子目录里用 docker build 构建，除非你显式指定构建上下文和 Dockerfile 路径——否则 Docker 会报错找不到 Dockerfile 或依赖文件。
为什么子目录构建会失败
Docker 默认只把当前目录（含所有子目录）作为构建上下文上传给守护进程。如果你在 src/backend 下执行 docker build -t myapp .，Docker 就只会上传 src/backend/ 及其内容，上层的 pom.xml、package.json 或根目录 Dockerfile 全部不可见。
常见错误现象包括：
ERROR: Cannot locate specified Dockerfile: Dockerfileerror: failed to solve: failed to read dockerfile: open /var/lib/docker/tmp/buildkit-mount*/Dockerfile: no such file or directory- Maven 构建阶段报
Could not find goal 'package' in plugin org.apache.maven.plugins:maven-jar-plugin（因为没上传pom.xml）
正确指定构建上下文和 Dockerfile 路径
核心原则：构建命令必须从能访问所有必要文件的目录执行，或通过参数显式指向它们。
假设项目结构如下：
my-project/
├── pom.xml
├── Dockerfile
└── src/
└── backend/
└── ...
你想在 src/backend 目录下触发构建（比如 CI 脚本或 IDE 插件默认行为），那就必须回退到项目根目录，并用 -f 和上下文路径配合：
- 进入子目录只是“操作位置”，不是“构建起点”——别在
src/backend里运行docker build . - 改用：
docker build -f ./Dockerfile -t myapp:latest .（在项目根目录执行） - 如果非要从子目录发起命令，可用相对路径指定上下文：
docker build -f ../../Dockerfile -t myapp:latest ../.. - Windows PowerShell 中注意路径分隔符，
..\..有效，但不要混用/和\
Docker Desktop GUI 或 IDE 插件里的配置要点
Docker Desktop 本身不提供“子目录构建”开关，IDE（如 IntelliJ）的 Docker 插件在配置 Build Image 时，关键字段是：
-
Dockerfile：填绝对路径或相对于项目根的路径，例如Dockerfile或./Dockerfile（不能写src/backend/Dockerfile除非它真在那里） -
Build context：必须设为项目根目录（如C:\my-project），不是子目录 - 如果插件自动填充了当前打开的子目录作为 context，手动改成上级目录，否则
COPY ..类指令一定失败 - IntelliJ 的 “Docker” 运行配置中，
Image tag留空会用默认名，但Context directory错了就白搭
多模块 Maven 项目怎么安全地从子模块构建
典型场景：父 pom.xml 在根目录，子模块 backend/ 有自己 pom.xml，但 Dockerfile 仍放在根目录（因需调用 mvn package 打整个项目）。
这时不能让 Dockerfile 里写 COPY backend/target/*.jar ./app.jar 并从 backend/ 构建——因为 target/ 是构建产物，不在源码上下文中。
推荐做法：
- 保持
Dockerfile在项目根目录，用标准多阶段构建：mvn clean package -pl backend -am在第一阶段生成 jar，再COPY --from=0 backend/target/*.jar ./app.jar - 若坚持子目录构建，先在根目录执行
mvn clean package，再在backend/写一个轻量Dockerfile，仅COPY ../backend/target/*.jar——但要确保../backend/target已存在且被包含进上下文（即 context 设为..） - 永远检查
docker build --no-cache输出的第一行：“Sending build context to Docker daemon …” 后面的字节数是否合理；过小说明上下文太窄，漏了关键文件
最易被忽略的是：Docker Desktop 的状态栏图标右键菜单里没有“构建”入口，一切构建动作都依赖 CLI 或 IDE 集成——而它们对上下文路径的校验非常严格，错一位路径，整个构建就静默失败或中途报错。
