Pixelfed 联邦时间线功能故障排查与修复

问题背景

Pixelfed 是一个开源的联邦式图片分享平台，在最近的 v0.11.11 版本更新后，多个实例管理员报告了联邦时间线功能异常的问题。主要表现为全局时间线仅显示本地内容，而无法显示来自其他实例的联邦内容。

问题现象

管理员在升级到 v0.11.11 版本后，发现以下症状：

1. 全局时间线仅显示本地发布的帖子
2. 通知中心仅显示本地互动
3. 虽然管理面板显示内容已正确导入，但前端不显示

初步排查

根据社区反馈，问题可能与以下因素无关：

• 实验性功能 EXP_CHT 或 EXP_CPT 未启用
• 服务器资源充足（RAM 和 CPU 使用率正常）

临时解决方案

在官方修复前，管理员可以尝试以下临时措施：

1. 执行 php artisan cache:clear 命令清除缓存
2. 检查移动应用和网页端的表现差异（部分用户报告移动应用可能正常工作）

根本原因

开发团队通过分析发现，这是一个与联邦内容显示逻辑相关的代码问题。具体表现为前端未能正确获取和显示来自其他实例的内容，尽管后端已成功接收并存储这些数据。

官方修复

开发团队在 issue #4924 中提供了修复方案。该修复：

1. 修正了联邦内容查询逻辑
2. 优化了缓存处理机制
3. 确保移动端和网页端表现一致

验证结果

多个实例管理员确认：

• 更新后联邦时间线功能恢复正常
• 全局时间线现在正确显示来自其他实例的内容
• 通知系统能够显示联邦互动

最佳实践建议

为避免类似问题，建议管理员：

1. 在升级前检查 GitHub issue 列表中的已知问题
2. 升级后立即清除缓存
3. 同时测试网页端和移动端功能
4. 关注官方文档的更新说明

总结

这次事件展示了开源社区协作解决问题的典型流程：用户报告问题、开发者分析原因、快速提供修复方案、社区验证效果。Pixelfed 团队对联邦功能问题的快速响应确保了平台的稳定性和用户体验。