Skip to content

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 参考以获取有效指令及其语法

相关资源

相关术语

相关课程

← 返回语言