Tauri项目中WebviewWindow使用additionalBrowserArgs导致白屏问题的分析与解决

问题现象

在Tauri项目开发过程中，当开发者在tauri.conf.json配置文件中设置了additionalBrowserArgs参数后，尝试通过JavaScript API创建额外的WebviewWindow窗口时，会出现窗口显示为空白且无法操作的问题。即使将参数值设为空字符串，问题依然存在；而完全移除该配置项后，窗口则能正常显示内容。

问题根源

经过分析，这个问题与Tauri底层处理Webview窗口的方式有关。当配置了additionalBrowserArgs参数时，Tauri要求必须使用不同的数据目录(data_directory)来存储Webview的相关数据。这是因为浏览器参数的变化会导致Webview实例的初始化方式不同，需要隔离数据存储以避免冲突。

然而，当前版本的Tauri存在一个设计限制：通过JavaScript API创建的WebviewWindow无法访问Rust端的配置信息，包括data_directory和运行时版本的additional_browser_args参数。这导致当主窗口和附加窗口使用不同的浏览器参数时，附加窗口无法正确初始化，从而出现白屏现象。

解决方案

针对这个问题，开发者可以采取以下几种解决方案：

1. 使用Rust端创建窗口：将窗口创建逻辑迁移到Rust代码中，这样可以直接访问完整的配置信息。

2. 预配置隐藏窗口：在tauri.conf.json中预先配置好所有需要的窗口，设置visible: false使其初始隐藏，然后在需要时通过JavaScript控制显示。虽然这会预先消耗一些系统资源，但能保证窗口正常工作。

3. 寻找替代方案：如果使用additionalBrowserArgs只是为了忽略证书错误，可以考虑其他方式实现相同功能，避免修改浏览器参数。

错误处理建议

开发过程中还可能会遇到一个看似相关但实际上无关的错误信息："Failed to unregister class Chrome_WidgetWin_0"。这个错误通常在应用程序关闭时出现，属于Webview2内部处理的正常现象，不会影响程序功能，开发者可以忽略。

最佳实践

对于需要在Tauri项目中使用多个Webview窗口的场景，建议：

• 尽量保持所有窗口使用相同的浏览器参数配置
• 优先考虑在tauri.conf.json中预先声明所有窗口
• 如果必须使用不同的浏览器参数，确保为每个配置创建独立的数据目录
• 复杂的多窗口场景建议使用Rust端进行统一管理

通过理解Tauri窗口管理的内在机制，开发者可以更有效地构建稳定可靠的多窗口应用程序。