Firebase Cloud Messaging 无法识别User_Properties 推送符合条件用户数为0

针对你遇到的「Analytics可正常展示已上报的用户属性、自定义定义也已完成配置，但推送定向筛选时符合条件用户数为0」的问题，核心原因集中在数据同步规则、匹配逻辑、阈值校验三个层面，逐一排查即可定位问题：

核心成因 #

• 数据同步机制差异
  Analytics看板的用户属性展示，基于近实时的事件流聚合计算，数据延迟通常在数分钟级别即可展示；但推送定向用到的用户标签资产，依赖离线批处理管道同步，存在固定的24-48小时同步周期，刚完成属性配置、自定义定义添加的阶段，数据还未同步到推送模块的标签库时，筛选结果就会直接显示为0。
• 属性值匹配规则错位
  定向推送的标签匹配为精确字符串匹配，一旦代码上报的属性值、自定义定义中配置的可选值存在大小写差异、前后空格、特殊字符、空值等不一致问题，后台就无法匹配到有效用户。另外如果上报的属性值类型不符合要求（比如用布尔值、嵌套对象作为属性值），即使Analytics能正常展示，推送模块也无法识别这类无效标签。
• 自定义属性的定向阈值未达标
  平台不会把所有上报过的用户属性都纳入可定向标签池，必须满足两个基础条件：一是该属性累计被至少2个非匿名的真实用户上报过，二是属性被手动开启了可用于定向的权限。如果只有1个测试账号上报过对应属性，或是添加自定义属性时默认关闭了定向开关，永远不会产生可匹配的用户列表。
• 跨模块资源不匹配
  如果配置用户属性的项目资源，和当前发送推送的应用不属于同一个项目空间，或是当前操作账号没有推送模块读取用户标签的权限，模块会因为拉取不到对应标签的用户数据，直接返回0条匹配结果。

落地排查解决步骤 #

• 满足数据同步等待周期
  完成属性上报、自定义定义配置后，预留48小时的等待周期让后台完成数据同步。期间可以在Analytics的用户属性报表中确认，已有至少3个非测试的真实用户稳定上报对应属性值，避免测试数据占比过高拉低有效标签的统计基数。
• 全链路核对属性值一致性
  逐字符对比代码中上报的属性名、属性值，以及Custom Definitions中配置的自定义属性参数，确保没有拼写错误、大小写偏差、多余空格等问题；同时调整上报逻辑，过滤空字符串、null值这类无效的属性上报值，避免无效数据挤占标签匹配的计数。
• 校验自定义属性的定向权限与状态
  进入Custom Definitions的User-Properties板块，找到对应配置的属性，确认两个状态：一是属性整体显示为「Active」有效状态，二是属性的可用于定向开关处于开启状态——大部分刚添加的自定义属性默认是关闭定向权限的，需要手动开启后数据才会同步到推送模块的标签库。
• 排查跨模块资源连通性
  确认当前发送推送的应用，和上报用户属性的应用属于同一个项目下的关联应用，不存在多项目资源串用的问题；如果是通过第三方平台集成的推送能力，需要核对平台侧的用户属性字段映射关系，确认没有字段名拼写错误导致的标签匹配失败。

内容的提问来源于stack exchange，提问作者Nadhir Falta