CefSharp 进程单例模式与 OnAlreadyRunningAppRelaunch 回调机制解析

在 CefSharp 120.1.110 版本中，Chromium 内核引入了一个重要的行为变更——默认启用了进程单例模式。这一变更对开发者如何处理多实例应用场景产生了深远影响。

进程单例模式的核心机制

Chromium 设计上要求每个缓存路径只能被单个进程独占访问。新版本中，当检测到相同 RootCachePath 的实例已运行时，CEF 会触发 OnAlreadyRunningAppRelaunch 回调。这一机制通过以下方式工作：

1. 后续实例启动时会检查进程单例锁
2. 将新启动参数转发给已运行的进程
3. 新实例提前退出（返回 false 时）
4. 主进程收到回调后可决定处理方式

开发者应对策略

对于需要支持多实例的场景，必须为每个实例配置唯一的 RootCachePath。最佳实践包括：

1. 显式设置 RootCachePath 避免使用默认路径
2. 实现 IBrowserProcessHandler.OnAlreadyRunningAppRelaunch
3. 检查 Cef.Initialize() 返回值处理早期退出

典型实现示例：

public class CustomBrowserProcessHandler : BrowserProcessHandler
{
    public override bool OnAlreadyRunningAppRelaunch(ICommandLine commandLine, string currentDirectory)
    {
        // 自定义处理逻辑
        return true; // 返回true表示已处理，阻止默认行为
    }
}

技术原理深度解析

该机制底层基于 Chromium 的进程间通信架构：

• 通过共享内存实现进程单例检测
• 使用命名管道进行参数传递
• UI 线程安全退出机制保障稳定性

在多线程消息循环模式下（CefSharp 默认），需要特别注意线程同步问题。开发者应当了解：

1. 回调发生在浏览器进程的 UI 线程
2. 命令参数对象生命周期仅限于回调期间
3. 返回值的处理会影响整个应用生命周期

版本兼容性说明

从 120.1.110 版本开始，此行为成为强制要求。开发者需要注意：

1. 未设置 RootCachePath 将触发警告日志
2. 未实现回调会导致默认 Chrome 样式窗口创建
3. 多实例场景必须保证缓存路径隔离

对于需要保持旧版行为的应用，可通过集成到现有消息循环来临时规避，但这并非推荐方案。长期解决方案应当遵循新的进程管理规范。

通过合理利用这一机制，开发者可以实现更符合现代应用规范的单例模式应用，同时保证缓存系统的完整性和稳定性。