Readarr在TrueNAS Core环境下添加根目录后崩溃问题分析与解决方案

问题现象分析

在TrueNAS Core 13.0-U5.3系统环境中部署Readarr时，用户反馈在添加根目录后出现服务不稳定的情况。具体表现为：

1. 界面操作时频繁出现"Failed to load translations from API"错误提示
2. Web界面加载困难，需要多次刷新才能恢复访问
3. 在线图书搜索功能失效
4. 问题在0.3.32.2587和0.4.0.2634两个版本中均复现

根本原因

经过技术分析，发现该问题与BSD系统环境下Watch Folder功能的兼容性问题有关。当用户在TrueNAS Core（基于FreeBSD）系统中启用根目录监控功能时，会导致Readarr服务出现异常行为。

解决方案

针对此问题，建议采取以下解决步骤：

1. 禁用Watch Folder功能：

   • 进入Readarr设置界面
   • 找到"媒体管理"或"Media Management"选项
   • 禁用"启用监视文件夹"或"Enable Watch Folder"功能

2. 系统升级建议：

   • 考虑将TrueNAS Core升级至TrueNAS Scale（基于Linux）
   • 新版系统对Readarr等应用有更好的兼容性支持

技术背景

在BSD系统环境中，文件系统监控机制与Linux存在差异。Readarr的Watch Folder功能依赖于系统底层的文件监控API，在FreeBSD系统上可能会出现以下问题：

• 文件系统事件通知机制不兼容
• 监控句柄泄漏导致资源耗尽
• 系统调用超时引发服务异常

最佳实践建议

对于TrueNAS用户，建议：

1. 使用稳定的Linux发行版作为基础环境
2. 在必须使用FreeBSD系统时，避免启用文件监控类功能
3. 定期检查应用日志，监控服务稳定性
4. 考虑使用计划任务替代实时监控功能

后续维护

用户反馈在禁用Watch Folder功能后，Readarr服务已恢复正常运行。该解决方案在TrueNAS Core环境下验证有效，可作为同类问题的标准处理流程。