Jellyfin数据库只读错误分析与解决方案

问题现象

在Windows 11环境下运行的Jellyfin 10.10.3版本服务器，在执行媒体文件迁移操作后出现服务异常。具体表现为：

1. 用户登录界面可以显示，但任何登录尝试都会失败
2. 系统日志显示"attempt to write a readonly database"错误
3. 即使用户凭证正确，系统也无法完成认证流程

技术分析

从错误日志可以看出，核心问题是SQLite数据库被锁定为只读模式。这种情况通常由以下原因导致：

1. 文件系统权限异常：迁移操作可能改变了数据库文件的NTFS权限
2. 磁盘错误：长时间的文件操作可能引发底层存储问题
3. 进程锁定：服务停止/启动过程中可能残留了文件句柄
4. 插件冲突：某些插件（如PlaybackReporting）可能在启动时尝试修改数据库

解决方案

初级排查步骤

1. 检查%ProgramData%\Jellyfin\Server目录权限
2. 验证磁盘剩余空间和健康状况
3. 暂时移除插件目录中的非核心插件

有效解决方法

通过系统文件检查工具修复：

sfc /scannow

该命令会：

• 扫描所有受保护的系统文件
• 修复损坏的文件版本
• 恢复正确的文件权限设置

预防建议

1. 进行大规模文件操作前，建议：

   • 完整备份Jellyfin数据目录
   • 使用robocopy等工具保持ACL权限
   • 在低负载时段执行操作

2. 定期维护：

   • 每月执行磁盘检查
   • 保持系统补丁更新
   • 监控数据库文件完整性

技术原理

Windows系统文件检查器(SFC)通过以下机制修复此类问题：

1. 对比当前文件与缓存的正确版本
2. 自动从WinSxS存储中恢复原始文件
3. 重置错误的ACL条目
4. 修复损坏的注册表项关联

对于媒体服务器这类需要持续访问数据库的服务，保持底层文件系统的健康状态至关重要。建议用户在遇到类似问题时，优先考虑系统级的完整性检查，再排查应用层问题。