TFS 2017.2事件通知被过滤的原因咨询

我之前处理过不少TFS 2017.2的通知过滤问题，当你看到tbl_eventnotification表中状态变为filtered时，通常是以下几个核心原因导致的，结合排查步骤帮你定位问题：

1. 订阅过滤条件与事件实际内容不匹配 #

这是最常见的原因。比如你创建的订阅设置了特定的过滤规则——比如只关注"分配给我的Bug"、"特定区域路径下的工作项变更"，或者"迭代路径处于Sprint 1的任务"——当触发事件的资源（比如工作项）不符合这些规则时，通知引擎就会直接过滤掉这条通知。

排查方式：

• 从tbl_eventnotification中找到被过滤通知的subscriptionid，然后在TFS的Team Web Access中找到对应的订阅详情；
• 对比订阅的过滤条件和eventdata字段里的JSON数据（解析后），看看是否存在字段值不匹配的情况（比如Assignee字段不是订阅者、工作项区域路径不在订阅范围内等）。

2. 订阅者缺乏资源访问权限 #

TFS的通知引擎会做权限校验，如果订阅者没有访问事件关联资源的权限，为了避免泄露敏感信息，这条通知会被标记为filtered。比如某个工作项在私有区域路径下，订阅者没有该区域的读取权限，就会触发这个情况。

排查方式：

• 用订阅者的账号登录TFS，尝试访问触发事件的工作项/资源，如果无法打开，说明权限是问题根源，需要调整资源的权限设置。

3. 订阅的目标范围不匹配 #

如果你的订阅是针对特定团队、用户组或者项目的，但触发事件的资源不在这个范围内，也会被过滤。比如团队订阅了"本团队工作项变更"，但工作项的区域路径不属于该团队的管辖范围，通知就会被拦截。

排查方式：

• 检查订阅的目标对象（团队/组/项目），确认事件资源是否属于这个范围；
• 如果是团队订阅，核对团队的区域路径设置是否包含该工作项。

4. 全局通知规则的限制 #

如果TFS管理员配置了全局通知策略（比如禁止某些类型的通知、或者针对特定用户组过滤通知），可能会覆盖个人或团队的订阅规则，导致部分通知被过滤。

排查方式：

• 联系TFS管理员，检查全局通知设置里是否有针对该事件类型或订阅者的过滤规则。

5. 事件元数据异常 #

偶尔会出现事件本身的元数据不完整或格式异常的情况，比如工作项的某些关键字段为空，导致订阅的过滤条件无法正确评估，最终被标记为filtered。

排查方式：

• 解析tbl_eventnotification中的eventdata字段，查看是否存在缺失的字段、格式错误或者不符合预期的值。

内容的提问来源于stack exchange，提问作者Josh Handel