Python单实例应用：如何等待已有实例结束后再运行？

你遇到的问题核心在于Mutex等待逻辑的实现细节和进程退出时的资源清理不到位。调试时单步执行的环境会让资源释放时机更明确，但直接运行时，进程退出的资源回收延迟或等待逻辑的疏漏会导致新进程无法正确获取Mutex。

关键修复点及解决方案 #

• 使用全局命名空间的Mutex：给Mutex名称加上Global\前缀，避免会话隔离（比如不同用户登录、终端服务会话的场景），确保新进程能识别到已有实例的Mutex。
• 循环带超时等待Mutex：用WaitForSingleObject设置合理超时（比如1秒），循环检查Mutex状态，避免无限阻塞且无法处理异常情况。
• 强制释放Mutex：在进程退出前（包括异常退出）主动释放Mutex，避免残留的Mutex锁死后续进程。
• 处理异常退出场景：识别WAIT_ABANDONED状态，处理前一个实例崩溃导致的Mutex遗弃情况。

修正后的代码示例 #

import win32api
import win32event
import sys

def main():
    # 全局命名的Mutex，跨会话可见
    mutex_name = "Global\\MySingleInstanceAppMutex"
    # 创建/打开Mutex，初始不占用
    mutex = win32event.CreateMutex(None, False, mutex_name)
    error_code = win32api.GetLastError()

    if error_code == win32api.ERROR_ALREADY_EXISTS:
        print("It's already running... Waiting...")
        # 循环等待，每次检查间隔1秒
        while True:
            wait_status = win32event.WaitForSingleObject(mutex, 1000)
            if wait_status == win32event.WAIT_OBJECT_0:
                print("Previous instance exited. Starting now...")
                break
            elif wait_status == win32event.WAIT_ABANDONED:
                print("Previous instance crashed. Taking over...")
                break
            # WAIT_TIMEOUT时继续循环

    try:
        # 替换为你的应用核心逻辑
        print("Application is running...")
        input("Press Enter to exit the app...")
    finally:
        # 无论正常/异常退出，都释放并关闭Mutex句柄
        win32event.ReleaseMutex(mutex)
        win32api.CloseHandle(mutex)

if __name__ == "__main__":
    main()

额外注意事项 #

• 确保安装了最新版pywin32库，避免旧版本API的兼容性问题。
• 普通用户权限通常足够创建全局Mutex，若涉及UAC提升的进程，可额外配置Mutex的安全属性（一般场景无需额外设置）。

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