Node.js如何等待localhost:8000服务器启动后执行测试？

阿华AIGC实验室

2026-4-30

解决服务器启动后轮询等待就绪的问题

你的问题核心有两个：一是用exec启动长期运行的服务器会导致主进程阻塞，二是现有的轮询逻辑写法有误，导致无法正确检测服务器状态。我来一步步帮你修正：

首先修正服务器启动的方式

exec会等待子进程执行完毕才返回，但python manage.py startserver是持续运行的，所以这里应该用child_process.spawn——它不会阻塞主进程，还能更好地管理子进程：

const { spawn } = require('child_process');
const util = require('util');
const fetch = require('node-fetch');

class CreateEnv {
  async Execute () {
    try {
      console.log("Create database and runserver...");
      // 用spawn启动服务器，stdio: 'inherit'可同步服务器输出到控制台，方便调试
      this.serverProcess = spawn('python', ['manage.py', 'startserver'], {
        stdio: 'inherit'
      });

      // 监听服务器启动失败的情况
      this.serverProcess.on('error', (err) => {
        console.error('Failed to start server:', err);
        throw err;
      });

      // 等待服务器就绪
      await waitForServer('http://127.0.0.1:8000');
      console.log("Server started and ready to accept requests!");
      // 这里可以开始执行你的测试逻辑
    } catch (e) {
      console.error(e);
      console.log("Error creating database and runserver...");
      // 异常时杀掉服务器进程，避免僵尸进程
      if (this.serverProcess) this.serverProcess.kill();
      return;
    }
  }
}

然后编写正确的轮询检测函数

你的waitforlocalhost函数存在语法错误（比如fetch后的逗号、未定义的resolve、async函数混用回调），我们重新写一个基于Promise的轮询函数，支持重试次数和超时设置：

async function waitForServer(url, maxRetries = 20, retryInterval = 1000) {
  let retries = 0;
  while (retries < maxRetries) {
    try {
      const response = await fetch(url);
      if (response.status === 200) {
        return; // 服务器就绪，退出轮询
      }
    } catch (err) {
      // 捕获连接错误，打印重试状态后继续
      console.log(`Waiting for server... (attempt ${retries + 1}/${maxRetries})`);
    }
    retries++;
    // 等待指定间隔后重试
    await new Promise(resolve => setTimeout(resolve, retryInterval));
  }
  // 超过最大重试次数，抛出错误
  throw new Error(`Failed to connect to server at ${url} after ${maxRetries} attempts`);
}

关键细节说明

spawn vs exec：spawn专为长期运行的进程设计，不会等待进程退出；而exec是为短期命令打造的，会缓存输出直到进程结束，所以这里必须用spawn。
轮询逻辑：用while循环+await setTimeout实现异步轮询，避免频繁请求占用资源，同时通过重试次数限制防止无限等待。
错误处理：监听服务器进程的error事件，轮询超时后主动抛出错误，异常时清理服务器进程，避免资源泄漏。
资源清理：测试结束后，可调用this.serverProcess.kill()关闭服务器，根据你的测试流程调整即可。