解决 Docker 中 Node.js 中的“缺少启动脚本”错误

解决方案 1：调整 Dockerfile 和 Package.json 以正确复制文件

该解决方案利用 Docker 和 Node.js 确保文件正确复制到 距离 文件夹并且 NPM 可以找到 开始 脚本。

# Dockerfile
FROM node:18 AS builder
WORKDIR /app
# Copy necessary config files and install dependencies
COPY package*.json tsconfig.json ./
RUN npm install
# Copy all source files and build the project
COPY . .
RUN npm run build
# Production stage
FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/package*.json ./
RUN npm install --omit=dev
COPY --from=builder /app/dist ./dist
EXPOSE 3001
# Adjust command to start the server
CMD ["node", "dist/server.js"]

解决方案2：修改docker-compose.yml进行环境控制

该解决方案修改了 docker-compose.yml 配置以指定正确的命令并确保脚本在 Docker 中正确运行。

# docker-compose.yml
version: "3.9"
services:
  backend:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3001:3001"
    environment:
      PORT: 3001
    depends_on:
      - dynamodb
    command: ["npm", "run", "start"]
  dynamodb:
    image: amazon/dynamodb-local
    ports:
      - "8001:8000"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000"]
      interval: 10s
      timeout: 5s
      retries: 5

解决方案 3：验证和更新 Package.json 脚本

该解决方案涉及确保 开始 脚本在中正确定义 包.json 文件以防止丢失脚本错误。

{
  "name": "backend",
  "version": "1.0.0",
  "main": "dist/server.js",
  "scripts": {
    "build": "tsc",
    "start": "node dist/server.js",
    "dev": "nodemon --exec ts-node src/server.ts",
    "clean": "rimraf dist"
  }
}

单元测试：确保脚本和 Docker 配置完整性

这些 Jest 测试验证基本文件是否已正确复制以及 NPM 脚本在容器环境中是否正常运行。

// test/deployment.test.js
const fs = require('fs');
describe('Deployment Tests', () => {
  test('dist folder exists', () => {
    expect(fs.existsSync('./dist')).toBe(true);
  });
  test('start script exists in package.json', () => {
    const packageJson = require('../package.json');
    expect(packageJson.scripts.start).toBe("node dist/server.js");
  });
  test('Dockerfile has correct CMD', () => {
    const dockerfile = fs.readFileSync('./Dockerfile', 'utf8');
    expect(dockerfile).toMatch(/CMD \["node", "dist\/server.js"\]/);
  });
});

有关修复 Node.js 中“缺少启动脚本”的常见问题

1. 是什么原因导致 NPM 中出现“缺少启动脚本”错误？
2. 当 package.json 文件没有 start 脚本已定义。 NPM 找不到启动应用程序的正确入口点。
3. 是否 package.json 文件需要位于 dist 文件夹？
4. 不，该 package.json 通常驻留在根目录中，仅将必要的文件复制到 dist 文件夹。
5. 为什么我们在 Docker 中使用多阶段构建？
6. 多阶段构建使我们能够创建轻量级、生产就绪的容器。通过分离构建和运行时环境，排除不必要的文件，提高安全性和效率。
7. 如何 healthcheck 在 Docker Compose 中有帮助吗？
8. 这 healthcheck 命令检查服务是否已启动并正在运行，这在需要首先准备好依赖服务（例如数据库）的情况下至关重要。
9. 在此设置中我可以使用其他数据库代替 DynamoDB 吗？
10. 是的，您可以更换 DynamoDB 与其他数据库。调整 Docker Compose 配置以适合您首选的数据库服务。
11. 为什么我们使用 RUN npm install --omit=dev 命令？
12. 此命令仅安装生产依赖项，这有助于通过排除开发工具来保持容器的轻量级。
13. 我怎样才能确认 dist 文件夹是否正确复制？
14. 您可以在代码中添加测试来检查是否 dist 存在，或者在构建后使用 Docker CLI 检查容器的内容。
15. 我需要在 Dockerfile 和 Docker Compose 中指定端口吗？
16. 是的，在两者中指定端口可确保容器端口与主机端口匹配，从而使服务可以从 Docker 外部访问。
17. 为什么设置 WORKDIR 在Docker中重要吗？
18. 环境 WORKDIR 为所有命令创建默认目录路径，简化文件路径并系统地组织容器文件。
19. 如何查看 Docker 日志来调试此错误？
20. 使用 docker logs [container_name] 访问日志，可以深入了解任何启动错误或丢失的文件。

修复 Docker 中的 Node.js 启动错误

解决“缺少启动脚本”错误需要注意细节，特别是在配置 Docker 的文件结构和 NPM 脚本方面。检查您的 Dockerfile 以确保编译的文件已复制到 距离 文件夹并且正确定义了 package.json 中的启动脚本可以节省您数小时的调试时间。

维护清晰的设置和有组织的脚本将有助于 Docker 容器顺利运行，并且在 Docker Compose 中使用运行状况检查可确保服务按正确的顺序加载。通过这些调整，您的后端应该能够可靠地启动，从而为您提供更顺畅的开发工作流程。 🛠️