CEF中自定义backend://协议注册后功能异常的问题

我之前在做CEF自定义协议开发的时候踩过几乎一模一样的坑，结合你的描述，咱们来一步步拆解解决这两个核心问题：

一、POST二进制数据接收失败的根源与修复 #

当你没有调用AddCustomScheme时，CEF会把自定义scheme当成“非标准”协议处理，默认不支持POST请求的二进制payload传递——这就是你收不到数据的原因。要解决这个问题，必须在注册scheme时明确开启POST支持，同时完善handler的读取逻辑：

1. 注册scheme时添加POST支持参数 #

在浏览器进程和渲染进程的CefInitialize调用之前，为两个scheme添加必要的选项：

// 全局scheme注册代码，两个进程都要执行，且必须在CefInitialize前调用
CefRefPtr<CefSchemeRegistrar> registrar = CefGetGlobalSchemeRegistrar();

// 配置backend:// scheme
registrar->AddCustomScheme(
    "backend",
    SCHEME_OPTION_SUPPORTS_GET | 
    SCHEME_OPTION_SUPPORTS_POST | 
    SCHEME_OPTION_ALLOW_STANDARD_URL_ENCODING |
    SCHEME_OPTION_SECURE // 如果需要在HTTPS页面中访问，添加这个选项
);

// 配置client:// scheme
registrar->AddCustomScheme(
    "client",
    SCHEME_OPTION_SUPPORTS_GET | 
    SCHEME_OPTION_SUPPORTS_POST | 
    SCHEME_OPTION_ALLOW_STANDARD_URL_ENCODING |
    SCHEME_OPTION_SECURE
);

这里的SCHEME_OPTION_SUPPORTS_POST是核心，它告诉CEF这个scheme可以处理POST请求；SCHEME_OPTION_ALLOW_STANDARD_URL_ENCODING则确保二进制数据不会被错误编码。

2. 完善Handler的POST数据读取逻辑 #

你的自定义CefResourceHandler必须实现ReadRequestBody方法才能读取二进制POST数据：

class BackendSchemeHandler : public CefResourceHandler {
private:
    size_t read_offset_ = 0; // 记录已读取的POST数据位置

public:
    // ... 其他方法实现 ...

    bool ReadRequestBody(CefRefPtr<CefRequest> request,
                        void* data_out,
                        size_t bytes_to_read,
                        size_t& bytes_read) override {
        CefRefPtr<CefPostData> post_data = request->GetPostData();
        if (!post_data || post_data->GetElementsCount() == 0) {
            bytes_read = 0;
            return false; // 无更多数据
        }

        CefPostDataElementList elements;
        post_data->GetElements(elements);
        // 假设POST数据是单个二进制元素（如果是多元素需要遍历处理）
        CefRefPtr<CefPostDataElement> element = elements[0];
        if (element->GetType() == PDE_TYPE_BYTES) {
            size_t available = element->GetBytesCount() - read_offset_;
            bytes_read = std::min(bytes_to_read, available);
            
            if (bytes_read > 0) {
                element->GetBytes(bytes_read, data_out, read_offset_);
                read_offset_ += bytes_read;
                return true;
            }
        }

        bytes_read = 0;
        return false;
    }

    // 在OnRequest中重置读取偏移量
    void OnRequest(CefRefPtr<CefRequest> request,
                   CefRefPtr<CefCallback> callback) override {
        read_offset_ = 0;
        // ... 其他请求初始化逻辑 ...
    }

    IMPLEMENT_REFCOUNTING(BackendSchemeHandler);
};

client://的handler也要做同样的修改，确保能正确读取POST二进制数据。

二、多Scheme注册后处理器异常的排查与修复 #

同时调用AddCustomScheme后出现异常，大概率是两个进程的scheme配置不一致或者handler工厂映射错误导致的，解决步骤如下：

1. 确保两个进程的scheme配置完全一致 #

浏览器进程和渲染进程中，AddCustomScheme的参数（scheme名称、选项flags）必须完全相同——哪怕是一个flag的差异，都会导致CEF内部状态混乱，触发异常。比如不要在浏览器进程给backend加SCHEME_OPTION_SECURE，渲染进程却不加。

2. 正确实现Scheme Handler Factory #

在浏览器进程的CefClient实现中，要确保GetSchemeHandlerFactory能根据scheme名称返回对应的handler：

class MyClient : public CefClient {
public:
    CefRefPtr<CefSchemeHandlerFactory> GetSchemeHandlerFactory() override {
        return new MySchemeHandlerFactory();
    }

    // ... 其他Client方法实现 ...

    IMPLEMENT_REFCOUNTING(MyClient);
};

class MySchemeHandlerFactory : public CefSchemeHandlerFactory {
public:
    CefRefPtr<CefResourceHandler> Create(
        CefRefPtr<CefBrowser> browser,
        CefRefPtr<CefFrame> frame,
        const CefString& scheme_name,
        CefRefPtr<CefRequest> request) override {
        // 严格匹配scheme名称，注意大小写（CEF不区分，但统一写法更安全）
        if (scheme_name == "backend") {
            return new BackendSchemeHandler();
        } else if (scheme_name == "client") {
            return new ClientSchemeHandler();
        }
        return nullptr; // 返回nullptr表示不处理该scheme
    }

    IMPLEMENT_REFCOUNTING(MySchemeHandlerFactory);
};

注意：渲染进程不需要注册handler工厂，只需要调用AddCustomScheme即可。

3. 排查常见异常触发点 #

• 检查handler中是否存在空指针访问（比如没判断request、post_data是否为空）；
• 确保每个scheme的handler都是独立的实例，不要复用同一个handler处理不同scheme；
• 如果是崩溃异常，用调试工具查看调用栈，通常能定位到CEF内部因scheme配置不一致导致的错误。

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