Node.js 如何判断端口是否被占用

在 Node.js 的开发过程中，我们经常会遇到需要监听特定端口的情况。然而，如果该端口已经被其他程序占用，就会导致程序无法正常启动。判断端口是否被占用是一个非常重要的任务。

利用 net 模块是一个常用的方法。net 模块是 Node.js 内置的用于创建 TCP 或 IPC 服务器与客户端的模块。我们可以创建一个 TCP 服务器实例，尝试去监听指定端口。如果监听成功，说明该端口没有被占用；若监听失败，则表明端口已被占用。

以下是具体代码示例：

const net = require('net');

function checkPort(port) {
    const server = net.createServer();
    return new Promise((resolve, reject) => {
        server.on('error', (err) => {
            if (err.code === 'EADDRINUSE') {
                resolve(false);
            } else {
                reject(err);
            }
        });
        server.on('listening', () => {
            server.close();
            resolve(true);
        });
        server.listen(port);
    });
}

// 使用示例
checkPort(3000)
 .then((isAvailable) => {
        if (isAvailable) {
            console.log('端口 3000 可用');
        } else {
            console.log('端口 3000 已被占用');
        }
    })
 .catch((err) => {
        console.error('检查端口时发生错误:', err);
    });

在这段代码中，checkPort 函数接收一个端口号作为参数。它创建了一个 TCP 服务器，并返回一个 Promise。当服务器监听成功时，会触发 listening 事件，此时关闭服务器并返回 true，表示端口可用；当监听失败且错误码为 EADDRINUSE 时，说明端口被占用，返回 false；如果是其他错误，则直接拒绝 Promise 并抛出错误。

通过这种方式，我们能够方便地在 Node.js 应用中判断某个端口是否已经被占用，从而合理地安排端口使用，确保程序能够顺利运行。这对于开发稳定可靠的 Node.js 应用来说是至关重要的一步。无论是小型项目还是大型企业级应用，准确判断端口占用情况都有助于优化资源配置和提高应用的性能。