Node.js 如何检测并防止重复进程，实现单实例命令转发？

这是个非常实用的需求，不管是桌面应用还是后台工具，单实例运行能避免资源冲突、重复操作这类问题，还能通过命令转发让已有实例响应新指令。我来给你拆解下核心思路和具体实现方案：

1. 文件锁（跨平台首选） #

原理很简单：程序启动时尝试创建一个特定的锁文件，并对其申请独占排他锁。如果成功，说明当前是第一个实例；如果失败（文件已被锁定），则证明已有实例在运行。

这种方法的优势是跨平台（Windows、Linux、macOS都支持），而且系统会在进程退出后自动释放锁，不用担心残留问题。需要注意锁文件的路径要唯一，比如放在用户目录（~/.yourapp/instance.lock）或者系统临时目录，避免不同用户的程序互相干扰。

举个Python的跨平台例子（用portalocker库简化操作）：

import os
import portalocker

LOCK_FILE_PATH = os.path.expanduser("~/.myapp/instance.lock")

# 确保锁文件目录存在
os.makedirs(os.path.dirname(LOCK_FILE_PATH), exist_ok=True)

try:
    lock_file = open(LOCK_FILE_PATH, "w")
    portalocker.lock(lock_file, portalocker.LOCK_EX | portalocker.LOCK_NB)
except portalocker.LockException:
    print("应用已在运行中！")
    exit(1)

# 后续程序逻辑...

2. 本地端口监听 #

让第一个实例监听一个本地回环端口（比如127.0.0.1:54321），后续实例启动时尝试连接这个端口：

• 如果连接成功，说明已有实例在运行；
• 如果连接失败（端口未被占用），则自己作为第一个实例启动并监听端口。

这种方法的额外好处是：端口本身可以作为命令转发的通道，不用额外搭建IPC通信机制。

当新实例检测到已有实例后，需要把当前的命令行参数发送给已有实例，然后自己退出。常用的IPC方式有：

• TCP Socket：刚才提到的本地端口，直接用socket发送数据；
• 命名管道（Windows）/Unix域套接字（Linux/macOS）：比TCP更轻量的本地通信方式；
• 共享内存：适合传递大数据，但实现相对复杂。

这里用TCP Socket举个完整的例子，Python实现：

完整示例代码 #

import socket
import sys
import threading

def handle_client(conn):
    # 接收新实例发送的命令参数
    cmd_args = conn.recv(1024).decode("utf-8")
    print(f"收到新命令：{cmd_args}")
    # 这里添加处理命令的逻辑，比如调用对应函数执行操作
    conn.close()

def start_server():
    server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    server_socket.bind(("127.0.0.1", 54321))
    server_socket.listen(5)
    
    while True:
        conn, addr = server_socket.accept()
        # 开启线程处理客户端请求，避免阻塞主程序
        threading.Thread(target=handle_client, args=(conn,)).start()

# 先尝试连接，判断是否已有实例在运行
try:
    client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    client_socket.connect(("127.0.0.1", 54321))
    # 发送当前命令行参数（跳过程序本身的路径）
    client_socket.send(" ".join(sys.argv[1:]).encode("utf-8"))
    client_socket.close()
    print("命令已转发至运行中的实例！")
    exit(0)
except ConnectionRefusedError:
    # 没有实例在运行，启动服务端
    print("启动新实例...")
    # 后台启动服务线程，不阻塞主程序
    threading.Thread(target=start_server, daemon=True).start()

# 主程序逻辑示例
input("按回车退出程序...")

• 资源唯一性：不管用文件锁还是端口，要确保标识（锁文件路径、端口号）是你程序独有的，避免和其他软件冲突；
• 异常处理：比如已有实例意外崩溃，部分系统不会自动释放锁文件，这时候可以检查锁文件对应的进程是否存在，再决定是否强制解锁；
• 跨语言适配：如果是其他语言，比如C#可以用Mutex类，Java可以用FileLock或者ServerSocket，核心思路都是一致的。

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