owncast

这是 Owncast v0.2.5 的一个已知内置 bug，会同时影响 favicon 上传和重置功能。后端对这些端点错误地返回了 401 Unauthorized 的非 JSON 响应，从而触发前端 JSON 解析错误，并导致即使输入了有效的登录信息，仍会反复提示输入管理员凭据。该修复已在 pull request #4879 中合并，请升级到高于 v0.2.5 的 Owncast 官方版本即可解决此问题。

这影响 Owncast 0.3.0+ 搭配 next-export-i18n 至 2.4.3。它的 useSelectedLanguage() 读取 window.localStorage.getItem("next-export-i18n-lang") 时没有防护，即使配置了 languageDataStore: 'query' 也是如此。因此，Android WebView 中为 null 的 localStorage 或第三方 iframe 中的 SecurityError 会导致 React 树崩溃。

Android WebView 变通方案：
webView.settings.domStorageEnabled = true

Java：
webView.getSettings().setDomStorageEnabled(true);

Owncast 永久修复：在 React 渲染前安装一个内存中的 Storage shim，例如在 pages/_app.tsx 顶部，或在一个最先导入的模块中：
if (typeof window !== 'undefined') {
const createMemoryStorage = (): Storage => {
let data: Record<string, string> = {};
return {
getItem: key =>
Object.prototype.hasOwnProperty.call(data, key) ? data[key] : null,
setItem: (key, value) => {
data[key] = String(value);
},
removeItem: key => {
delete data[key];
},
clear: () => {
data = {};
},
key: index => Object.keys(data)[index] ?? null,
get length() {
return Object.keys(data).length;
},
};
};

try {
if (!window.localStorage) throw new Error('localStorage is unavailable');
window.localStorage.getItem('__owncast_storage_test__');
} catch {
Object.defineProperty(window, 'localStorage', {
configurable: true,
value: createMemoryStorage(),
});
}
}

然后查看器和 /embed/video 可正常渲染；在受限环境中，存储的值只是不会在重新加载后持久保留。或者，使用 patch-package 防护该库的 getItem 调用，但该补丁必须在依赖更新后重新应用。仅设置 languageDataStore: 'query' 并不能修复此崩溃。