CefSharp结合EasyTabs多实例异常：多主进程问题求助

一、先修复Mutex单实例控制失效的核心问题 #

很多时候Mutex不起作用，是因为没加全局命名空间前缀，或者进程退出时没正确释放，导致会话隔离或残留锁。正确实现方式：

static Mutex _appMutex;

[STAThread]
static void Main()
{
    bool isNewInstance;
    // 加Global\前缀避免终端服务下的会话隔离，名称用你的应用唯一标识
    _appMutex = new Mutex(true, @"Global\YourUniqueAppID_2024", out isNewInstance);

    if (!isNewInstance)
    {
        // 已有实例，通知主进程开新标签后直接退出当前进程
        NotifyMainProcessToOpenTab();
        return;
    }

    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    // 关键：只在主进程初始化一次CefSharp
    Cef.Initialize(new CefSettings
    {
        MultiThreadedMessageLoop = true // 避免UI线程阻塞
    });

    // 启动EasyTabs主窗口
    var tabbedWindow = new TitleBarTabs();
    tabbedWindow.Tabs.Add(new TitleBarTab(tabbedWindow)
    {
        Content = new YourCefSharpBrowserForm(),
        Title = "初始标签"
    });
    tabbedWindow.SelectedTabIndex = 0;

    Application.Run(tabbedWindow);

    // 退出时释放资源
    _appMutex.ReleaseMutex();
    Cef.Shutdown();
}

二、跨进程通知主进程创建新标签 #

不要让新进程启动完整程序，而是通过Windows消息通知主进程开新标签，避免多主进程：

private static void NotifyMainProcessToOpenTab()
{
    // 通过主窗口标题找到句柄，也可以用窗口类名
    IntPtr mainWindowHandle = FindWindow(null, "你的EasyTabs主窗口标题");
    if (mainWindowHandle != IntPtr.Zero)
    {
        // 发送自定义消息
        const int WM_CUSTOM_NEW_TAB = 0x0400 + 1;
        SendMessage(mainWindowHandle, WM_CUSTOM_NEW_TAB, IntPtr.Zero, IntPtr.Zero);
        // 把主窗口调到前台
        SetForegroundWindow(mainWindowHandle);
    }
}

// 导入Win32API
[DllImport("user32.dll", SetLastError = true)]
private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);

[DllImport("user32.dll")]
private static extern bool SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

[DllImport("user32.dll")]
private static extern bool SetForegroundWindow(IntPtr hWnd);

然后在EasyTabs主窗口的WndProc里处理消息：

protected override void WndProc(ref Message m)
{
    const int WM_CUSTOM_NEW_TAB = 0x0400 + 1;
    if (m.Msg == WM_CUSTOM_NEW_TAB)
    {
        // 新建CefSharp标签页
        this.Tabs.Add(new TitleBarTab(this)
        {
            Content = new YourCefSharpBrowserForm(),
            Title = "新标签页"
        });
        this.SelectedTabIndex = this.Tabs.Count - 1;
    }
    base.WndProc(ref m);
}

三、EasyTabs+CefSharp的关键注意事项 #

• 每个标签页的Content对应的CefSharp窗体不要单独初始化Cef，必须复用主进程的Cef环境，否则会触发多主进程。
• WPF环境下用EasyTabs.Wpf时，要确保所有CefSharp操作在Dispatcher线程执行，避免跨线程异常。
• 测试时彻底关闭所有应用实例再重启，避免残留的Mutex未释放（必要时重启电脑清除锁）。

四、排查多主进程的常见坑 #

• 检查是否有分支代码导致新进程也执行了Cef.Initialize，只要执行这个方法，当前进程就会被Cef标记为主进程。
• 确认Mutex名称绝对唯一，不要用通用名称，比如加上公司域名或产品UUID。

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