Dockerfile 指令错误:无效命令
快速摘要
你的 Dockerfile 有无效指令 —— 构建器无法解析 Dockerfile。
为什么发生
Dockerfile 指令拼写错误(如 RUNN 而非 RUN)
指令在错误上下文中使用(如多阶段构建中 ENTRYPOINT 后的 COPY)
指令语法格式错误 —— 缺少参数或格式错误
最小示例
✗ 错误代码
FROM node:18-alpine
WORKDIR /app
COPYY . . # typo: COPYY instead of COPY
RUN npm install
CMD ["node", "server.js"]✓ 修复代码
FROM node:18-alpine
WORKDIR /app
COPY . . # correct instruction
RUN npm install
CMD ["node", "server.js"]将指令名称从 COPYY 更正为 COPY 使 Dockerfile 有效,构建成功。
如何诊断
阅读构建错误消息中的未知指令和行号
查看 Dockerfile 参考以获取有效指令及其语法
验证每个指令有正确数量的参数和格式
如何修复
更正指令名称以匹配有效的 Dockerfile 指令
将指令移到多阶段构建中正确的上下文或阶段
修复指令语法 —— 添加缺失参数或更正格式
如何预防
在构建前使用 hadolint 等 Dockerfile linter 捕获无效指令
参考 Dockerfile 参考以获取有效指令及其语法