Docker Cloud Stack部署应用失败：服务因脚本未找到停止

我来帮你排查这个「本地/docker-compose正常，但Docker Cloud Stack部署时提示脚本找不到」的问题，这种情况大多和镜像构建的细节、路径匹配或者配置覆盖有关，咱们一步步拆解分析：

本地测试正常不代表推送到仓库的镜像里有正确的文件。你可以先拉取云端仓库的镜像，在本地检查文件结构：

# 拉取镜像
docker pull your-docker-repo/your-image:tag
# 查看镜像内的目标路径文件
docker run --rm your-docker-repo/your-image:tag ls -l /app/dist  # 替换成你预期的路径

如果输出里没有index.js，那问题出在镜像构建时没把dist文件夹正确复制进去，接下来检查Dockerfile的COPY逻辑。

假设你的本地项目结构是这样的：

your-project/
├── src/
│   └── dist/
│       └── index.js
└── Dockerfile

那Dockerfile里的路径配置要严格对应：

# 设置工作目录
WORKDIR /app
# 把本地的dist文件夹复制到镜像的/app/dist下
COPY src/dist/ /app/dist/
# 启动命令要对应镜像内的路径
CMD ["node", "dist/index.js"]

常见错误点：

• 构建镜像时不在项目根目录执行docker build，导致COPY的相对路径出错（比如在src目录下构建，那src/dist/会变成src/src/dist/，自然找不到）
• COPY命令写成了COPY dist/ /app/dist/但实际本地dist在src目录下，或者反过来

有时候Stack文件里的command字段会覆盖Dockerfile中定义的CMD/ENTRYPOINT。比如你的Stack文件如果是这样：

app:
  image: your-docker-repo/your-image:tag
  command: node src/dist/index.js  # 这里的路径和镜像内实际路径不匹配

那即使Dockerfile里写的是dist/index.js，云端部署时也会用Stack里的命令，导致找不到脚本。解决办法是：

• 删掉Stack里的command字段，让镜像使用自身的CMD启动
• 或者把command里的路径改成镜像内的实际路径（比如node dist/index.js）

如果你的.dockerignore或.gitignore文件里有dist这条规则，Docker构建镜像时会自动忽略这个文件夹，导致镜像里没有index.js。你可以打开这两个文件检查：

• 如果确实排除了dist，要么删除这条规则，要么确保构建镜像前dist文件夹已经生成，并且构建上下文包含它
• 临时测试可以用docker build --no-ignore .强制不忽略，但不推荐长期这么做，最好调整ignore规则

有时候文件权限不足会导致Node无法读取index.js。你可以进入镜像内部检查：

docker run --rm -it your-docker-repo/your-image:tag sh
# 查看文件权限
ls -l /app/dist/index.js

如果权限显示不是可读的，可以在Dockerfile里添加一行修正权限：

RUN chmod +r /app/dist/index.js

内容的提问来源于stack exchange，提问作者Hyo