HarmonyOS 鸿蒙NEXT Push Kit v3 REST API 服务端推送持续返回 80200001

HarmonyOS 鸿蒙NEXT Push Kit v3 REST API 服务端推送持续返回 80200001 谢谢各位老师，问题已解决：是因为我没有把官方说明文档里的“调用推送服务REST API”和“示例代码”这两部分同步给AI，所以AI不知道怎么改，导致一直在没出问题的地方打转。

归根结底还是我的问题：认为这两部分不重要，更根本的原因是对于整个流程不熟悉，后面也会加强相关方面的学习。

以下是一些不相关的碎碎念：

确实之前一直用AI做的都是一些比较小且独立的功能，第一次涉及系统方面的权限/api调用，我一开始甚至连生成鉴权令牌都看不懂，只觉得怎么这里也给一个json那里也给一个json（现在我的文件夹里还有好多json，一个也不敢删……）所以最开始完全依赖AI，出问题之后才开始找官方说明文档一点点排查错误（然后把最关键的信息漏掉了）。

烧了小一百块钱tokens修改迭代了23个版本之后总算成功实现了这个功能，手机通知横幅弹出、通知铃声响起的时候收获了无与伦比的开心。谢谢各位老师的解答和帮助！祝老师们永远不会遇到bug！

=======================================

各位老师好，我是一个完全的新人，正在试图通过AI给我个人开发的应用加入PushKit推送功能，但是调试了一整天还是没能成功，所以让AI总结了一下遇到的问题，想麻烦各位老师帮忙看一下是哪里出错了、应该如何修改。如果有描述不到位的地方，请各位老师批评指正。

环境：

• HarmonyOS NEXT，targetSdkVersion 6.0.2(22)
• 服务端：Node.js（Vercel Serverless），TypeScript
• Push Kit v3 接口

已完成的配置：

• AGC 已开启 Push Kit 服务
• 客户端 pushService.getToken() 成功获取 token（长度112），token 在 AGC 控制台"测试消息"功能可正常推送成功
• 从 AGC 控制台下载了服务账号密钥 JSON 文件，包含 project_id、sub_account、key_id、private_key

服务端鉴权代码（Node.js，使用 Web Crypto API）：

// JWT 生成 + 换取 access_token
async function getHuaweiAccessToken(): Promise<string> {
    // 从环境变量读取密钥文件中的字段
    // HUAWEI_KEY_ID = "3cc5d5be66e5470fb2a47f8cc34fe5ae"
    // HUAWEI_SUB_ACCOUNT = "117526863"
    // HUAWEI_PROJECT_ID = "101653523863958499"
    // HUAWEI_PRIVATE_KEY = PEM 格式 RSA 私钥
    const pem = rawKey.replace(/\\n/g, '\n')
    const b64 = pem.replace(/-----BEGIN PRIVATE KEY-----|-----END PRIVATE KEY-----|\s/g, '')
    const keyBytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0))
    const cryptoKey = await crypto.subtle.importKey(
        'pkcs8', keyBytes.buffer,
        { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['sign']
    )
    const now = Math.floor(Date.now() / 1000)
    // JWT header: { alg: 'RS256', kid: keyId, typ: 'JWT' }
    // JWT payload: { iss: subAccount, aud: 'https://oauth-login.cloud.huawei.com/oauth2/v3/token', iat: now, exp: now+3600 }
    // ... base64url 编码 + RS256 签名 ...
    // 换取 access_token
    const res = await fetch('https://oauth-login.cloud.huawei.com/oauth2/v3/token', {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: 'grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=' + jwt
    })
    // res.ok = true，成功拿到 access_token（前12位形如 DgEBAMCoANoS）
}

推送调用代码：

await fetch('https://push-api.cloud.huawei.com/v3/101653523863958499/messages:send', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json;charset=utf-8',
        'Authorization': `Bearer ${accessToken}`,
        'push-type': '0'
    },
    body: JSON.stringify({
        validate_only: false,
        message: {
            token: ["设备token（112位）"],
            android: {
                notification: { title: "标题", body: "内容", click_action: { type: 3 } }
            }
        }
    })
})

响应：

{"code":"80200001","msg":"Authentication Error","requestId":"..."}

已排查项：

1. ✅ JWT exchange 成功（能拿到 access_token）
2. ✅ URL 中 projectId = 密钥文件中 project_id = 101653523863958499
3. ✅ 使用 v3 接口
4. ✅ 设备 token 有效（AGC 控制台测试成功）
5. ✅ iss = sub_account（改成 project_id 会报 “jwt iss not matched”）
6. ❓ 服务账号是否需要在某个地方单独授权 Push 发送权限？

问题： access_token 拿到了，但 push API 始终返回 80200001，请问是哪里配置有问题？服务账号是否需要在 AGC 控制台某处手动授权？