Node.js默认端口被占用时自动切换端口的方法咨询

当然可以实现这个需求，下面是一套完整的实现方案，结合端口检测、用户交互和自动端口查找逻辑：

核心思路 #

• 先尝试在默认端口启动服务器
• 若端口被占用，通过命令行询问用户是否切换端口
• 获得用户同意后，从默认端口的下一位开始逐个检测，找到第一个可用端口并启动服务器

完整实现代码 #

const http = require('http');
const net = require('net');
const readline = require('readline');

const DEFAULT_PORT = 3000;

// 创建命令行交互接口
const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

// 检测指定端口是否可用
function checkPortAvailable(port) {
  return new Promise((resolve) => {
    const server = net.createServer();
    server.unref();
    server.on('error', () => resolve(false));
    server.listen(port, () => {
      server.close(() => resolve(true));
    });
  });
}

// 询问用户是否切换端口
function askUser() {
  return new Promise((resolve) => {
    rl.question(`端口 ${DEFAULT_PORT} 已被占用，是否自动切换到可用端口？(y/n) `, (answer) => {
      rl.close();
      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
    });
  });
}

// 从指定起始端口开始查找第一个可用端口
async function findAvailablePort(startPort) {
  let currentPort = startPort;
  while (true) {
    const isAvailable = await checkPortAvailable(currentPort);
    if (isAvailable) return currentPort;
    currentPort++;
  }
}

// 启动HTTP服务器
async function startServer(port) {
  const server = http.createServer((req, res) => {
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end(`Server running on port ${port}\n`);
  });

  try {
    await new Promise((resolve, reject) => {
      server.listen(port, () => resolve());
      server.on('error', reject);
    });
    console.log(`Server started successfully on port ${port}`);
  } catch (err) {
    if (err.code === 'EADDRINUSE') {
      const userAgree = await askUser();
      if (userAgree) {
        const availablePort = await findAvailablePort(DEFAULT_PORT + 1);
        await startServer(availablePort);
      } else {
        console.log('服务器启动终止');
        process.exit(1);
      }
    } else {
      console.error('服务器启动失败:', err);
      process.exit(1);
    }
  }
}

// 启动程序
startServer(DEFAULT_PORT);

关键逻辑说明 #

• checkPortAvailable：通过创建临时TCP服务器检测端口状态，避免误判，检测完成后立即关闭临时服务器
• askUser：利用Node.js原生readline模块实现命令行交互，获取用户明确选择
• findAvailablePort：从默认端口的下一位开始循环检测，直到找到第一个可用端口
• startServer：核心启动流程，先尝试默认端口，若触发端口占用错误则进入用户询问和自动切换分支

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