uni-push 2.0 小米厂商通道离线消息不下发：sendMessage返回successed_offline但小米侧零下发

欢迎到专业群（ uni统计官方技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据您提供的详细排查信息和知识库中的相似案例，这是一个典型的厂商通道路由异常问题。由于 successed_offline 仅表示个推服务端已受理离线消息任务，并不保证厂商通道实际执行下发，结合小米侧统计为 0 的情况，说明消息在个推侧未能成功路由到小米推送接口。

基于知识库中 DCloud 官方人员的排查思路，请按以下步骤验证：

1. 检查小米系统级通知渠道设置（最常见原因）

根据 DCloud 官方人员在类似案例中的指引，即使个推配置正确，如果小米系统层面的通知渠道被用户关闭或分类不当，厂商通道会直接丢弃消息且小米后台统计为 0。

请在小米14上检查：

• 进入 设置 > 通知与控制中心 > 通知管理 > 找到"八折半-商家端"
• 确认您代码中使用的 channel_id（如 156926、156927）对应的渠道已启用
• 检查是否被归类为"静默通知"或"营销通知"导致被系统拦截

2. 验证 category 与 options 配置

根据 uni-push 消息分类管理文档，小米厂商通道对消息分类有严格要求。

建议的 sendMessage 参数结构：

await push.sendMessage({  
  push_clientid: 'd3274b6ed499c8dd9f2c7481eaef343e',  
  title: '测试标题',  
  content: '测试内容',  
  payload: {...},  
  force_notification: true,  
  // 小米需要正确的消息分类  
  category: {  
    xm: 'IM'  // 或您申请的具体分类  
  },  
  options: {  
    xm: {  
      // 小米特定参数，如需要 channel_id 应通过原生 SDK 设置  
      // 参考：https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/options.html  
    }  
  },  
  settings: {  
    strategy: {  
      default: 1,  // 离线走厂商通道  
      xm: 1        // 明确指定小米策略  
    }  
  }  
})

本助手使用国产模型，生成代码准确率较低。强烈建议使用uni-agent生成代码

3. 关于 Channel ID 的特殊说明

根据知识库中 DCloud 官方人员的说明，Channel ID 是 Android 标准概念，但各厂商实现不一：

• 小米/华为需要通过原生 SDK 在客户端设置 Channel ID
• 服务端推送时应通过 options 或 category 指定，而非仅依赖客户端设置
• 早期 Channel 配置方式已废弃，请确认未混用新旧配置方式

4. 申请开通厂商下发策略权限

根据 uni-push strategy 文档，精确控制厂商下发策略需要单独申请开通。

如果需要在云函数中强制指定小米通道策略（strategy.xm），请确认：

• 是否已在 DCloud 开发者后台申请开通厂商下发策略权限
• 如未开通，默认策略可能未正确路由到小米通道

5. 收集日志并提交工单

由于您已确认个推侧存在有效的小米 Device Token，但厂商侧零下发，这通常需要查询个推服务端的路由日志。

请通过 DCloud 官方渠道提交工单，并提供：

• TaskID: RASS_0921_7f5913284f6ce8313c910a2d404fecfe
• CID: d3274b6ed499c8dd9f2c7481eaef343e
• AppID: __UNI__F0AA0BA
• 具体时间点（精确到分钟）
• 小米开放平台应用包名: uni.app.UNIF0AA0BA

要求个推技术支持查询：

1. 该 TaskID 是否触发了小米厂商通道下发逻辑
2. 如果未触发，是策略判定问题还是 token 映射问题
3. 如果触发但失败，小米返回的具体错误码

补充建议

根据相似案例经验，可尝试以下验证：

• 卸载重装测试：完全卸载应用后重启手机，重新安装并获取新的 CID 测试（排除设备级缓存异常）
• 对比测试：使用 DCloud 开发者后台的推送测试工具（非云函数）向该 CID 发送离线消息，观察是否走通（可区分是云函数配置问题还是个推账户级问题）

由于 OPPO 正常而小米异常，大概率是小米特有的通道配置或权限问题，而非代码逻辑错误。