OBS-WebSocket插件在Unicode路径下的崩溃问题分析

问题背景

在Windows平台上，当用户使用包含Unicode字符（如中文、日文等）的用户名时，OBS-WebSocket插件在启动过程中会出现崩溃现象。这个问题主要影响Windows 11系统上的OBS Studio 30.2.2版本，导致用户只能以安全模式启动OBS。

技术分析

崩溃原因

崩溃发生在OBS-WebSocket插件尝试保存配置文件时。具体表现为：

1. 插件首次加载时会生成新的服务器密码
2. 在尝试保存配置文件时，由于路径包含Unicode字符，导致文件操作失败
3. 最终引发kernelbase.dll模块的异常

代码层面分析

问题的根源在于OBS-WebSocket插件5.5.2版本中对文件路径处理的改动：

1. 移除了原有的Qt实现的UTF-8路径处理机制（Utils::Platform::SetTextFileContent）
2. 新的SetJsonFileContent实现没有充分考虑Windows平台下Unicode路径的处理
3. 配置文件保存路径获取函数（GetModuleConfigPath）没有进行必要的字符编码转换

解决方案建议

临时解决方案

对于遇到此问题的用户，可以采取以下临时措施：

1. 创建一个不包含Unicode字符的新Windows用户账户
2. 在该账户下运行OBS Studio
3. 或者暂时使用OBS的安全模式

长期修复方案

从技术实现角度，建议采取以下修复措施：

1. 恢复使用Qt的QString进行UTF-8路径处理
2. 在Windows平台确保所有文件操作前进行正确的字符编码转换
3. 增强路径处理函数的Unicode支持能力

开发者注意事项

对于OBS插件开发者，这个问题提供了重要的经验教训：

1. 在跨平台开发中，必须特别注意文件路径的编码问题
2. Windows平台对Unicode路径的支持需要特殊处理
3. 文件操作相关的函数需要进行充分的平台兼容性测试

总结

OBS-WebSocket插件在Unicode路径下的崩溃问题凸显了跨平台软件开发中路径处理的重要性。通过恢复原有的Qt路径处理机制或实现更健壮的Unicode支持，可以有效解决这一问题。对于终端用户而言，在问题修复前，使用纯ASCII字符的账户路径是最可靠的临时解决方案。