PHP调用华为推送发送安卓通知

本文详细解析了PHP后端如何安全、稳定地调用华为HMS Push服务向安卓设备发送通知，重点揭示了绕过客户端SDK、直接通过HTTPS REST API实现推送的核心路径：先用client_id和client_secret动态获取1小时有效期的access_token并妥善缓存，再以Bearer认证方式构造严格校验的UTF-8 JSON请求体发送消息；同时直击开发痛点——深入剖析400/401错误根源（如token格式错误、字段为空、编码缺失、appid混淆）、提供可运行的cURL示例，并强调前后端协同关键点（如Android端HMS Core集成、华为账号登录、通知权限开启等），帮助开发者避开“返回success却收不到通知”的典型陷阱，真正打通从PHP服务端到用户通知栏的全链路。

华为 HMS Push SDK 的 PHP 后端调用方式

PHP 本身不直接支持华为推送的客户端 SDK（那是 Android/iOS 用的），真正能用 PHP 做的是调用华为的 https://push-api.cloud.huawei.com/v1/{appid}/messages:send 这个 HTTP 接口。你得自己构造请求、签名、发 JSON，不是装个扩展就能 send() 那么简单。

关键点在于：必须用服务端密钥（client_secret）换取访问令牌（access_token），再拿这个 token 去发消息。跳过这步，必返回 401 Unauthorized 或 invalid_request。

• 先去华为开发者联盟控制台 → 应用管理 → 你的应用 → “云推送” → “API 密钥管理”，拿到 client_id 和 client_secret
• access_token 有效期只有 1 小时，不能硬编码，要缓存并自动刷新
• 请求头必须带 Authorization: Bearer {access_token}，且 Content-Type 是 application/json; charset=UTF-8

PHP 发送通知时常见的 400 错误原因

华为接口对字段校验极严，一个空格、一个多余逗号、字段名拼错，都会返回 400 Bad Request 并附带模糊错误码（比如 message.invalid）。别猜，直接看响应体里的 error_description 字段。

• token 字段必须是设备真实的华为 Push Token（从 Android 客户端 HmsInstanceId.getInstance(context).getToken() 拿到），不是 Registration ID 或 FCM Token
• android 对象里 notification.title 和 notification.body 不能为 null 或空字符串；若只发数据消息（无通知栏展示），需显式设 "notification": null
• validate_only 设为 true 可预检请求结构是否合法，不会真推，适合调试
• 中文内容务必确保整个 JSON 是 UTF-8 编码，用 json_encode($data, JSON_UNESCAPED_UNICODE)，否则可能报 invalid_parameter

cURL 调用示例与关键参数说明

不用框架、不依赖 SDK，纯 cURL 最可控。下面这段能跑通，但注意替换 YOUR_APPID、YOUR_CLIENT_ID、YOUR_CLIENT_SECRET 和真实 DEVICE_TOKEN：

$ch = curl_init('https://oauth-login.cloud.huawei.com/oauth2/v3/token');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'grant_type' => 'client_credentials',
    'client_id' => 'YOUR_CLIENT_ID',
    'client_secret' => 'YOUR_CLIENT_SECRET'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);
$access_token = $response['access_token'];

// 发送消息
$message = [
    'validate_only' => false,
    'message' => [
        'token' => ['DEVICE_TOKEN'],
        'android' => [
            'notification' => [
                'title' => '测试标题',
                'body' => '这是 PHP 发来的通知'
            ]
        ]
    ]
];

$ch = curl_init('https://push-api.cloud.huawei.com/v1/YOUR_APPID/messages:send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $access_token,
    'Content-Type: application/json; charset=UTF-8'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($message, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);

注意：YOUR_APPID 是华为后台显示的 10 位数字 ID（不是包名），不是字符串形式的 App ID；token 字段必须是数组，哪怕只推一个设备。

Android 端没收到？先确认这三件事

后端发成功 ≠ 用户看到通知。华为推送在安卓侧有强依赖，很多问题出在客户端配置或环境上，PHP 这边查不到日志。

• 检查 Android 设备是否登录了华为账号（未登录则收不到）、是否在“设置→通知→华为推送服务”里开启权限
• 确认 App 已集成 HMS Core（APK 包里有 com.huawei.hms 相关类），且 agconnect-services.json 已正确放入 app/ 目录
• 调试时用 Logcat 过滤 HmsMessaging，看是否有 onNewToken 回调；如果一直拿不到 token，大概率是 HMS Core 版本太低或网络被墙（国内部分厂商手机需手动更新 HMS Core）

华为推送不像 Firebase 那样“开箱即用”，token 获取、离线消息、多厂商通道兼容这些环节，PHP 后端只能管住「发出去」这一步，剩下的得和安卓同学对齐细节。漏掉任意一环，都会卡在「明明返回 success 却没通知」。

今天关于《PHP调用华为推送发送安卓通知》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！