Audiobookshelf项目在Brave浏览器上传文件失败的技术分析

问题背景

在使用Audiobookshelf音频书管理平台时，部分Linux用户报告在使用Brave浏览器上传m4b格式的音频书文件时出现失败情况。值得注意的是，相同的操作在Firefox、Edge等其他浏览器上可以正常完成。

问题现象

用户在使用Brave 1.77.97版本(通过Arch Linux的AUR安装)时，点击上传按钮后立即出现错误提示"Oops, something went wrong"。浏览器控制台显示以下关键错误信息：

1. ERR_ACCESS_DENIED网络错误
2. RESULT_CODE_KILLED_BAD_MESSAGE的标签崩溃提示
3. 文件选择器可能返回了错误的文件路径

技术排查过程

经过深入分析，我们发现该问题具有以下特点：

1. 浏览器特异性：仅出现在Linux平台的Brave浏览器，Windows平台的Brave工作正常
2. 环境相关性：与文件存储位置有关，云同步目录下的文件上传会失败
3. 错误特征：属于前端网络请求被拒绝类型错误

根本原因

综合各项测试结果，确定问题根源在于：

Brave浏览器在Linux平台上处理云同步目录中的文件时，文件选择器组件存在兼容性问题。当用户从Nextcloud等云同步目录选择文件时，浏览器无法正确获取文件访问权限，导致上传请求被系统拒绝。

解决方案

对于遇到类似问题的用户，建议采取以下解决方案：

1. 临时解决方案：

   • 将待上传文件复制到非云同步的本地目录后再进行上传
   • 暂时改用Firefox等兼容性更好的浏览器完成上传操作

2. 长期解决方案：

   • 关注Brave浏览器更新，等待官方修复文件选择器组件的兼容性问题
   • 检查Brave浏览器的权限设置，确保有访问云同步目录的权限

技术启示

这个案例为我们提供了以下技术启示：

1. 浏览器文件上传功能的实现存在平台差异性，开发时需要考虑多平台兼容性
2. 云同步目录可能引入额外的文件访问权限控制，影响常规文件操作
3. 错误处理机制需要更加健壮，能够优雅地处理各种文件访问异常情况

总结

虽然这个问题最终确认不是Audiobookshelf平台本身的缺陷，但作为开发者，了解这类浏览器兼容性问题对于构建健壮的Web应用具有重要意义。建议开发者在处理文件上传功能时，充分考虑不同浏览器和操作系统的特性差异，并实现完善的错误处理和用户反馈机制。