Jellyfin在Apple Silicon macOS上的随机崩溃问题分析与解决方案

问题背景

近期在Apple Silicon架构的Mac设备上运行Jellyfin媒体服务器时，用户报告了一个严重的稳定性问题。当Jellyfin服务器在M2芯片的Mac mini上以互联网公开模式运行时，系统会在运行24-48小时（有时甚至长达一周）后随机崩溃。崩溃时会产生特定的错误日志，表明这是一个与.NET运行时相关的底层网络套接字处理问题。

技术分析

从错误日志中可以清晰地看到崩溃的根本原因：

System.ArgumentException: The supplied System.Net.SocketAddress is an invalid size for the System.Net.IPEndPoint end point

这个问题源于.NET运行时在处理网络连接时的边界条件异常。具体来说，当操作系统返回一个空地址时，.NET运行时的套接字处理逻辑没有正确验证地址大小，导致抛出未处理的异常，最终终止了主线程。

影响范围

该问题主要影响以下环境组合：

• 硬件：Apple Silicon芯片（M1/M2系列）的Mac设备
• 操作系统：macOS 15.x版本
• Jellyfin版本：10.10.x系列
• 运行模式：互联网公开访问的服务器配置

解决方案

微软.NET团队已经确认并修复了这个问题。修复包含在以下版本中：

• .NET 8.0.13版本（稳定版）
• .NET 9.0.2版本（开发版）

对于Jellyfin用户来说，解决方案分为两种情况：

1. 短期解决方案：

   • 在服务器设置中显式绑定到IPv4地址
   • 禁用IPv6支持
   • 定期重启服务（作为临时措施）

2. 长期解决方案：

   • 等待Jellyfin发布包含修复的更新版本
   • 手动升级底层.NET运行时（仅建议高级用户操作）

技术细节

这个问题的本质是操作系统网络栈与.NET运行时之间的交互异常。在极少数情况下，当网络连接建立时，macOS内核可能返回一个空地址结构，而.NET运行时的套接字处理代码没有正确处理这种边界情况。

修复后的版本增加了对地址结构的严格验证，确保在地址无效时能够优雅地处理错误，而不是直接抛出未处理的异常导致进程终止。

最佳实践建议

对于在Apple Silicon设备上运行Jellyfin的用户，我们建议：

1. 保持系统和Jellyfin版本更新
2. 对于生产环境，考虑使用更稳定的Linux平台
3. 监控服务器日志，特别是网络相关的警告和错误
4. 考虑使用进程监控工具自动重启崩溃的服务

结论

这个案例展示了跨平台软件开发中可能遇到的底层系统交互问题。通过社区报告和开发团队的协作，问题得到了快速定位和解决。随着.NET运行时和Jellyfin的持续更新，Apple Silicon用户将能够获得更加稳定的媒体服务器体验。