---

错误现象

在尝试启动一个基于自定义镜像的 Docker 容器时，遇到了以下报错：

/docker-entrypoint.sh: 47: exec: .: Permission denied

错误直接指向容器启动脚本 docker-entrypoint.sh 的第 47 行，提示执行 .（当前目录）时权限被拒绝。

产生的原因是，在docker run时，不小心在命令最后加了个.为什么会错得这么离谱呢？因为docker
build的时候有点，粘过来的时候站错了。

---

错误原因剖析

通过排查发现，根本原因在于 docker run 命令末尾误加了 .，例如：

docker run -it my_image .  # 错误示例：末尾多了一个点

这个看似不起眼的 .，实际触发了以下连锁反应：

1. 命令覆盖机制
   Docker 的 ENTRYPOINT 和 CMD 指令在运行时可能被覆盖。若 docker run 末尾附加参数，这些参数会直接替换 CMD 的默认值。
   例如，镜像中定义的 CMD ["npm", "start"] 会被覆盖为 CMD ["."]，导致容器启动时尝试将 .（当前目录）作为可执行文件运行。

2. 权限问题的根源

   • . 在 Linux 中代表当前目录，但直接执行目录会触发权限错误（目录默认不可执行）。
   • 若 docker-entrypoint.sh 脚本通过 exec "$@" 动态执行参数（常见于官方镜像），误传的 . 会被解析为执行目标，而目录本身没有可执行权限。

3. 环境变量干扰
   某些镜像可能通过环境变量动态加载启动命令（如 $APP_COMMAND），此时 . 可能被误解析为路径参数，导致脚本逻辑混乱。

---

修复过程

Step 1：验证命令语法
去掉 docker run 末尾的 .，恢复默认启动命令：

docker run -it my_image  # 正确命令（无额外参数）

若需覆盖 CMD，需明确指定完整命令，例如：

docker run -it my_image npm start

Step 2：检查镜像构建逻辑
检查 Dockerfile 中的 ENTRYPOINT 和 CMD 指令：

# 正确示例：ENTRYPOINT 定义入口脚本，CMD 提供默认参数
ENTRYPOINT ["/docker-entrypoint.sh"]
CMD ["npm", "start"]

避免在 CMD 中混入无关参数（如误写的 .）。

Step 3：修复脚本权限（可选）
若 docker-entrypoint.sh 本身权限不足，可在构建阶段添加执行权限：

RUN chmod +x /docker-entrypoint.sh

---

为何错误如此「离谱」？

1. 隐蔽的语法陷阱
   Docker 的命令行参数覆盖机制对新手不友好，多一个字符可能导致完全不同的行为。例如，docker run -it my_image . 与 docker run -it my_image 仅差一个 .，但前者会覆盖默认命令。

2. 环境依赖的误导性
   若开发环境中存在同名文件或目录（如当前目录下恰好有可执行文件 .），错误可能被掩盖；但在生产环境或其他机器上会暴露问题。

3. 脚本的容错性不足
   部分 docker-entrypoint.sh 未对输入参数做严格校验，直接执行 exec "$@"，导致传参错误时直接崩溃。

---

经验总结

1. 命令复制的风险

   • 从构建命令（docker build -t my_image .）复制到运行命令时，末尾的 .（构建上下文路径）容易被误带入 docker run，需特别注意。
   • 建议使用 Shell 脚本封装复杂命令，减少手动输入错误。

2. 防御性脚本设计
   在 docker-entrypoint.sh 中增加参数校验逻辑：

   if [ $# -eq 0 ] || [ "$1" = "." ]; then
     echo "Error: Missing or invalid command."
     exit 1
   fi
   exec "$@"
   

3. CI/CD 流程规范
   在持续集成中设置命令检查规则（如禁止 docker run 命令包含特定字符），避免低级错误进入生产环境。

---

附录：相关命令速查

场景	正确命令示例	错误命令示例
构建镜像	docker build -t my_image .	-
运行容器（默认命令）	docker run -it my_image	docker run -it my_image .
覆盖 CMD	docker run -it my_image npm run	docker run -it my_image .

通过这次踩坑，深刻体会到 「魔鬼藏在细节中」 —— 一个字符的偏差可能引发连锁故障。谨以此文提醒自己和读者：慎用复制粘贴，勤于校验参数！