Jellyfin-Danmaku插件本地XML弹幕加载失败问题分析与解决方案
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-danmaku 问题背景
在使用Jellyfin媒体服务器配合Danmaku插件时，部分用户遇到了无法加载本地XML格式弹幕文件的问题。具体表现为：当用户通过浏览器扩展尝试加载本地XML弹幕时，系统提示"本地弹幕加载失败"，而相同的XML文件在其他播放器(如弹弹PLAY)中却能正常工作。
环境配置
该问题出现在以下环境中：
- Jellyfin服务器版本：10.10.0
- Danmaku插件版本：1.49
- 浏览器环境：Chrome 130.0.6723.92正式版(64位)
- 使用方式：通过浏览器扩展加载
问题分析
经过深入排查，发现问题根源在于请求处理逻辑的不一致性。具体表现为：
- 在浏览器扩展环境下，
makeGetRequest函数返回的是直接的XML文本内容 - 在非浏览器扩展环境下，该函数返回的是标准的Response对象
- 代码中后续处理逻辑假设总是能获取Response对象，导致在浏览器扩展环境下无法正确解析返回结果
技术细节
问题的核心在于getCommentsByPluginApi函数的实现。原始代码如下：
async function getCommentsByPluginApi(jellyfinItemId) {
const path = window.location.pathname.replace(/\/web\/(index\.html)?/, '/api/danmu/');
const url = window.location.origin + path + jellyfinItemId + '/raw';
const response = await makeGetRequest(url);
if (!response.ok) {
return null;
}
const xmlText = await response.text();
if (!xmlText || xmlText.length === 0) {
return null;
}
在浏览器扩展环境下，makeGetRequest直接返回XML文本，而非Response对象，导致：
response.ok检查失败- 尝试调用
response.text()方法时出错
解决方案
开发者提供了两种解决方案：
-
临时解决方案：修改
getCommentsByPluginApi函数，直接使用返回的XML文本，跳过Response对象检查。这种方法虽然能解决问题，但不够优雅，且可能影响其他功能。 -
官方修复方案：开发者意识到问题后，重构了请求处理逻辑，使用标准的fetch API替代自定义的
makeGetRequest函数。这种方法更规范，能保证在各种环境下行为一致。
最佳实践建议
对于使用Jellyfin-Danmaku插件的用户，建议：
- 及时更新到最新版本的插件，以获得最稳定的体验
- 如果遇到类似问题，可先检查是否使用了浏览器扩展等特殊环境
- 在自定义开发时，注意处理不同环境下的API返回差异
总结
这个问题展示了环境差异对前端代码执行的影响，特别是在混合使用浏览器原生API和扩展API时。开发者在处理网络请求时，应当考虑不同执行环境下的行为差异，采用更通用的解决方案。对于用户而言，保持插件和服务器的最新版本是避免此类问题的最佳方式。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
