为什么华为消息推送配置失败，每个参数我都觉得没写错

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

华为消息推送配置失败，即使参数看似正确，通常是由于以下几个关键环节遗漏或配置不当导致的。请按以下步骤逐一排查：

1. 华为开发者后台配置

• SHA256证书指纹：确保在华为开发者后台（AppGallery Connect）的“项目设置 > 常规”中已正确填写应用的SHA256证书指纹，并点击保存。这是最常见的问题之一。
• 包名一致性：确认华为后台的应用包名与uni-app项目的包名完全一致（包括大小写）。
• 推送服务开通：在“项目设置 > 增长”中，确保已开通“推送服务”。
• 下载agconnect-services.json：从华为后台下载最新的agconnect-services.json文件，并确保其内容与当前应用匹配。

2. DCloud开发者中心配置

• 上传agconnect-services.json：在DCloud开发者中心的“厂商推送设置”中，必须上传从华为后台下载的agconnect-services.json文件。
• 参数填写：确保华为AppID、AppSecret等参数填写正确，且与华为后台一致。
• 重新云打包：保存参数后，必须重新提交云端打包，配置才能生效。

3. 客户端配置

• manifest.json：确保已开启uniPush功能，并正确配置了华为厂商通道。
• 自定义基座：如果使用了自定义基座，确保基座中已包含华为推送SDK。

4. 设备与环境

• 华为移动服务（HMS Core）：确保测试手机上已安装最新版本的HMS Core。
• 通知权限：检查手机的通知权限设置，确保应用的通知权限已开启，特别是“营销通知”权限（EMUI 10及以上设备）。
• 清除缓存：尝试清除HMS Core的缓存（手机设置 > 应用 > 应用管理 > 显示系统进程 > 华为移动服务 > 存储 > 清空缓存）。

5. 服务端推送参数

• 离线推送配置：在服务端推送时，确保push_channel字段中包含了华为厂商通道的配置，例如：

   "push_channel": {  
     "android": {  
       "ups": {  
         "notification": {  
           "title": "标题",  
           "body": "内容",  
           "click_type": "intent",  
           "intent": "intent:#Intent;launchFlags=0x04000000;action=android.intent.action.oppopush;component=你的应用包名/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=标题;S.content=内容;S.payload=test;end"  
         },  
         "options": {  
           "HW": {  
             "/message/android/urgency": "HIGH",  
             "/message/android/category": "PLAY_VOICE"  
           }  
         }  
       }  
     }  
   }  

  本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

• 自分类权益：如果使用了华为的自分类权益（如DEVICE_REMINDER），确保已在华为后台申请并通过审核。

6. 调试与日志

• 获取device token：通过uni.getPushClientId获取CID，确认是否能正常获取。如果无法获取，说明厂商通道未正确集成。
• ADB调试：使用ADB工具查看日志，确认是否有华为厂商返回的code码，帮助定位问题。

7. 参考文档

• UniPush华为厂商通道配置指南
• 华为推送服务官方文档

如果以上步骤均已确认无误，但问题仍未解决，建议提供具体的错误日志或截图，以便进一步分析。