为何内置Scheme需用Cef.GetGlobalRequestContext注册而非CefSettings？

一、为什么内置Scheme（HTTP/HTTPS）不能用CefSettings.RegisterScheme？ #

CEF（Chromium Embedded Framework）对HTTP/HTTPS这类内置Scheme有原生预注册逻辑，默认负责处理标准网络请求。CefSettings.RegisterScheme的设计目的是注册全新的自定义Scheme（比如myapp://、local://这类非标准协议），它会在CEF初始化阶段将新Scheme纳入全局协议体系。

对于已存在的内置Scheme，CefSettings.RegisterScheme无法覆盖或修改其默认处理逻辑——该方法仅用于添加新Scheme，而非修改已有Scheme的行为。强行用它注册内置Scheme，CEF会直接忽略操作，甚至可能引发初始化异常。

要修改内置Scheme的特定域名请求处理，必须在全局请求上下文初始化完成后，通过RegisterSchemeHandlerFactory为指定域名绑定自定义处理工厂，这样既能保留内置Scheme的全局默认行为，又能针对目标域名实现本地文件服务。

二、具体操作步骤与示例代码 #

核心步骤： #

1. 完成CEF初始化，确保全局请求上下文已创建；
2. 获取全局请求上下文实例；
3. 为HTTPS Scheme的目标域名注册FolderSchemeHandlerFactory，指向本地文件目录。

示例代码： #

using CefSharp;
using CefSharp.WinForms; // WPF环境替换为CefSharp.Wpf

class Program
{
    static void Main(string[] args)
    {
        // 初始化CEF基础设置
        var settings = new CefSettings();
        // 可按需添加其他配置，比如禁用GPU加速、设置缓存路径等

        // 初始化CEF，此步骤会创建全局请求上下文
        Cef.Initialize(settings);

        // 获取全局请求上下文实例
        var globalRequestContext = Cef.GetGlobalRequestContext();

        // 为HTTPS Scheme绑定指定域名的本地文件处理工厂
        bool registerSuccess = globalRequestContext.RegisterSchemeHandlerFactory(
            schemeName: "https",
            domainName: "cefsharp.test",
            factory: new FolderSchemeHandlerFactory(
                rootFolder: @"D:\Projects\CefSharp.Example\Resources", // 建议用绝对路径
                hostName: "cefsharp.test", // 匹配域名，传null则不做域名校验
                defaultPage: "home.html" // 访问根路径时默认加载的页面
            )
        );

        // 可选：校验注册结果
        if (!registerSuccess)
        {
            System.Console.WriteLine("HTTPS Scheme处理工厂注册失败");
        }

        // 后续初始化浏览器控件逻辑（以WinForms为例）
        var browser = new ChromiumWebBrowser("https://cefsharp.test");
        // 将browser添加到窗体容器中...

        // 程序退出时务必关闭CEF
        Cef.Shutdown();
    }
}

注意事项： #

• 时机要求：必须在Cef.Initialize()之后调用RegisterSchemeHandlerFactory，否则全局请求上下文未初始化会导致调用失败；
• 多进程场景：CEF默认开启多进程模式，主进程完成注册后，渲染进程会自动继承该配置；
• 路径问题：rootFolder优先使用绝对路径，避免相对路径在不同运行环境下出现文件找不到的问题。

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