Wry项目中macOS平台Web自定义协议请求崩溃问题解析

问题背景

在macOS平台上使用Wry框架注册自定义URI协议处理程序时，当Web端发起请求后但在响应完成前中止请求，会导致应用程序崩溃。这个问题主要影响使用Wry作为WebView后端的Tauri应用开发者，特别是在实现自定义协议处理逻辑时。

技术细节分析

该问题的核心在于macOS平台WKWebView对自定义协议请求处理的特殊性。当开发者通过register_asynchronous_uri_scheme_protocol注册自定义协议处理器时，系统会在WebView内部建立相应的请求处理机制。

崩溃发生的具体场景是：

1. Web端发起自定义协议请求
2. 在Rust端准备响应或正在发送响应过程中
3. Web端突然中止该请求
4. WKWebView内部抛出未捕获的NSException异常
5. 导致整个应用程序崩溃

解决方案演进

经过社区讨论和代码审查，开发团队确认了以下关键点：

1. 协议注册限制：WKWebView不允许覆盖系统原生支持的协议（如http/https）。尝试注册这些协议会导致不可预期的行为，包括应用崩溃。

2. 安全响应机制：在响应请求前，应当检查请求是否已被取消。如果请求已被取消，则不应继续发送响应。

3. 异常处理：在响应过程中添加适当的异常捕获机制，防止因请求中止导致的崩溃。

最佳实践建议

对于需要在Tauri应用中实现自定义请求处理的开发者，建议采用以下方案：

1. 使用自定义协议前缀：避免使用系统保留的协议名称（如http/https），选择独特的协议前缀。

.register_asynchronous_uri_scheme_protocol("myapp", |app, req, resp| {
    // 处理逻辑
})

2. 配置前端使用自定义协议：在tauri.conf.json中指定前端资源使用自定义协议加载：

{
    "build": {
        "frontendDist": "myapp://localhost"
    }
}

3. 完整的请求处理示例：

pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_shell::init())
        .register_asynchronous_uri_scheme_protocol("myapp", |app, req, resp| {
            let path = req.uri().path();
            // 根据路径返回静态文件或API响应
            resp.respond(
                Response::builder()
                    .status(StatusCode::OK)
                    .header("Content-Type", "text/html")
                    .body(b"Hello World".to_vec())
                    .unwrap(),
            );
        })
        .run(tauri::generate_context!())
        .expect("应用启动失败");
}

平台兼容性说明

需要注意的是，不同平台对自定义协议的支持存在差异：

• macOS：严格限制，不允许覆盖系统协议
• Windows：当前版本允许更多灵活性，但未来版本可能调整
• Linux：行为与macOS类似，受WebKitGTK限制

开发者应当针对目标平台进行充分测试，确保自定义协议处理逻辑的稳定性。

结论

该问题已在Wry框架的后续版本中得到修复。开发者应当遵循使用自定义协议而非系统协议的原则，并在处理请求时考虑请求可能被中止的情况，确保应用的稳定性。对于需要处理HTTP/HTTPS请求的场景，建议考虑其他方案如请求拦截API或使用传统的后端服务架构。