该错误本质是路径问题而非语法错误：docker 默认仅在构建上下文目录中查找严格命名为“dockerfile”（大小写敏感）的文件；需确认文件真实存在、执行目录正确、-f指定路径与上下文可同时访问。
docker build 报 “failed to read dockerfile” 是路径没对准
这个错误不是 Dockerfile 写错了，而是它压根没被找到。Docker 构建时默认只在构建上下文（build context）目录里找名为 Dockerfile 的文件（注意大小写，dockerfile 或 Dockerfile.txt 都不行）。常见现象是命令执行成功、日志里却突然冒出 failed to read dockerfile，接着构建直接中断。
- 运行
docker build前，先用ls -l Dockerfile（Linux/macOS）或dir Dockerfile（Windows cmd）确认文件真实存在且名字完全匹配 - 确保你在正确目录下执行命令：比如
Dockerfile在./backend/下，就 cd 进去再跑docker build -t myapp .，别在项目根目录下用docker build -f backend/Dockerfile .却忘了backend/里缺其他依赖文件 - 如果必须跨目录指定，用
-f参数时，路径是相对于当前 shell 工作目录的，不是相对于上下文目录 —— 比如docker build -f ./src/Dockerfile -t app .，这里的.是上下文，./src/Dockerfile是文件位置，两者要能同时访问
IDEA 里看不到 Dockerfile 或构建失败
IntelliJ IDEA 不是靠“文件名”识别 Dockerfile 的，而是靠插件 + 文件类型注册 + 项目结构感知。即使你手动创建了 Dockerfile，如果没触发 IDE 的识别逻辑，它就不会高亮、不提供语法检查、右键也没有 “Build Image” 选项。
- 确认已启用 Docker 插件：Settings > Plugins > 搜索 “Docker”，状态必须是 Enabled（不是 just installed）
- 新建文件时不要用 “New > File”，而要用 “New > Dockerfile”（IDEA 2021.3+ 默认支持），这样会自动绑定文件类型和语法支持
- 如果已有
Dockerfile但没识别，右键该文件 > “Override File Type” > 选 “Dockerfile”；或者删掉.idea/filetypes/缓存后重启 IDEA - IDEA 的 Docker 支持依赖于 Settings > Build, Execution, Deployment > Docker 中配置的 Docker server 能连上，如果 Docker Desktop 没启动或连接超时，IDEA 会静默忽略 Dockerfile
CI/CD（比如 Jenkins）里提示 Dockerfile 不存在
Jenkins 执行的是远程 agent 上的 shell，它的工作目录、用户权限、甚至文件系统挂载点，都和你本地终端完全不同。报 “no such file or directory” 很大概率不是路径写错，而是文件根本没拉下来，或权限被限制。
- 在 Jenkins 的 “Execute shell” 步骤开头加一句
pwd && ls -la，确认当前路径和Dockerfile是否真在那儿 - 检查 Jenkins 的源码拉取配置：是否勾选了 “Checkout to specific subdirectory”？是否用了 sparse checkout 过滤掉了
Dockerfile？ - 避免用相对路径拼接：不要写
docker build -f ../Dockerfile .，改用绝对路径（如/var/lib/jenkins/workspace/myjob/Dockerfile）并配合--context显式指定上下文 - 如果 Jenkins agent 运行在容器里，注意挂载卷是否覆盖了工作目录，或 SELinux/AppArmor 是否阻止读取宿主机上的
Dockerfile
Windows 上 WSL2 + Docker Desktop 的路径陷阱
在 Windows 上用 WSL2 后台运行 Docker Desktop，docker build 实际由 WSL2 中的 dockerd 执行，但文件路径经过了 Windows ↔ WSL2 的双向映射。这时看似正确的路径，可能在 WSL2 侧根本不可见。
- 别把
Dockerfile放在C:UsersxxxOneDrive或Google Drive同步目录下 —— WSL2 对这些路径的访问常被重定向或延迟，导致读取失败 - 优先把项目放在 WSL2 原生路径下（如
/home/username/project），再从 WSL2 终端里执行docker build；若必须从 Windows PowerShell 执行，确保路径是\wsl$Ubuntuhomeusernameproject这类可映射格式 - 检查 WSL2 中的
/etc/wsl.conf是否设置了automount=true和enabled=true，否则 Windows 盘符不会自动挂载到/mnt/c - 遇到中文路径报错（比如
failed to solve with frontend dockerfile.v0），直接重命名父目录为纯英文，WSL2 对 UTF-8 路径的支持仍不稳定
