Nextcloud服务器活动通知异常问题分析与解决方案

问题概述

Nextcloud服务器在31.0.0.1 RC1版本升级后出现了一系列活动通知相关的异常问题。主要表现为用户无法及时收到浏览器和移动设备的即时通知，同时系统日志中频繁出现活动(Activity)应用相关的错误信息。

核心问题表现

1. 通知功能异常：

   • 用户无法在浏览器和移动设备上收到即时通知
   • 邮件通知功能正常
   • 推送通知测试(occ push notifications test)工作正常
   • 日历事件推送通知功能正常

2. 日志错误信息：

   • 系统日志中频繁出现"Object is invalid, value XXXX is not a string"错误
   • 错误主要来自活动应用的RichObjectStrings验证器

3. 前端控制台错误：

   • 登录时控制台显示任务应用CSS文件的403错误
   • 打开Deck卡片时出现ResizeObserver错误
   • 点击通知铃铛时出现"Maximum call stack size exceeded"错误

技术分析

根本原因

问题根源在于Nextcloud 31版本中引入的RichObjectStrings验证机制。该机制要求所有活动通知中的对象ID必须是字符串类型，但系统中多个模块(如文件分享、评论、收藏等)传递的是整型ID，导致验证失败。

具体错误场景

1. 文件分享场景：

   • 分享文件时生成的活动中包含文件ID(整型)
   • 验证器期望文件ID为字符串类型
   • 导致"Object for placeholder file is invalid"错误

2. 评论场景：

   • 评论通知中包含评论ID(整型)
   • 验证失败导致评论通知无法正常发送

3. 收藏场景：

   • 添加文件收藏时生成的活动包含文件ID(整型)
   • 导致"Rich subject or a parameter for 'You added {file} to your favorites' is malformed"错误

解决方案

临时解决方案

对于遇到此问题的管理员，可以采取以下临时措施：

1. 清空相关数据库表：

   TRUNCATE oc_comments;
   TRUNCATE oc_comments_read_markers;
   TRUNCATE oc_activity;
   TRUNCATE oc_activity_mq;
   

2. 对于文件收藏问题，可以手动修改文件：

   修改apps/files/lib/Activity/FavoriteProvider.php
   将'id' => $subjectParams['id']改为'id' => (string)$subjectParams['id']
   

官方修复方案

Nextcloud开发团队已经针对此问题提交了多个修复补丁：

1. 主要修复补丁：

   • 确保所有活动通知中的对象ID在传递给验证器前转换为字符串
   • 修复了文件分享、评论等场景下的类型验证问题

2. 补丁状态：

   • 修复补丁已合并到主分支
   • 将在后续版本中发布

最佳实践建议

1. 升级建议：

   • 等待包含修复补丁的稳定版本发布后再进行升级
   • 如需立即升级，建议先测试环境验证通知功能

2. 错误处理：

   • 定期检查系统日志中的活动应用错误
   • 发现类似错误时可暂时禁用相关功能模块

3. 开发建议：

   • 开发自定义应用时确保活动通知中的ID字段为字符串类型
   • 使用类型检查确保数据格式符合验证器要求

总结

Nextcloud 31版本中的活动通知验证机制变更导致了此次兼容性问题。虽然问题影响多个功能模块，但本质原因相同。开发团队已经定位问题并提供了修复方案。建议管理员关注后续版本更新，及时应用修复补丁以确保系统通知功能正常运行。