必须用p8而非p12:p8是苹果官方推荐的Auth Key机制,长期有效、多App复用、无需频繁更新;p12已过时,易失效且DCloud后台仅对p8提供完整支持。

UniApp 配置 Apple Push 证书,现在应该直接用 p8 方式,别再折腾 p12 —— 它过时、易失效、多环境切换麻烦,且 DCloud 官方已明确推荐 p8 为 uni-push 2.0 的首选方案。
为什么必须用 p8 而不是 p12?
p12 是基于证书+私钥的双向绑定方式,每次 iOS 系统更新或证书过期就得重导、重传、重打包;而 p8 是苹果官方 Auth Key 机制,一个密钥文件可复用于同一团队下多个 App,且有效期无限(除非手动删除),DCloud 后台也只对 p8 提供完整支持。
-
p12在 uni-push 2.0 中已被标记为“兼容模式”,新项目上传会收到警告 - 苹果开发者后台已将
p8列为推送配置唯一推荐路径,p12入口正逐步隐藏 - 如果你在 DCloud 控制台看到「APNs 推送证书(p8)」输入框但没看到
p12选项,不是界面 bug,是它真没了
Apple Developer 后台必须完成的三步
跳过任何一步,p8 都无法生效。重点不是“怎么生成”,而是“是否满足前置条件”。
- 确认你的 App ID 已启用
Push Notifications:进入Identifiers→ 找到对应Bundle ID→ 点击编辑 → 勾选Push Notifications并保存(不点保存=没开) - 创建
p8Key 时必须勾选Apple Push Notifications service (APNs):在Keys页面点击+→ 名称随意(如uniapp-apns-prod)→ 勾选该服务 → 下载前务必记下页面显示的Key ID -
Team ID必须从账号页获取:不是组织名,不是 Bundle ID,是 Apple Developer 账号首页右上角「Account」→「Membership」页里显示的 10 位字母数字组合(如A1B2C3D4E5)
manifest.json 和 DCloud 控制台怎么填?
字段名和位置错一个,iOS 离线推送就静默失败——不会报错,但设备收不到通知。
为Claude Code提供对提醒事项、日历、联系人、笔记、邮件和tmux的本地命令访问权限,以便在macOS上进行工作流感知的个人操作。
- DCloud 控制台「Uni Push」→「配置管理」中,填入:
Key ID(来自苹果后台 Key 创建页)
Team ID(来自 Membership 页面)
Bundle ID(必须和 manifest.json 中bundleIdentifier完全一致,区分大小写)
上传下载好的AuthKey_XXXXXXXXXX.p8文件(仅限一次,丢了只能重建) - manifest.json 中确保有:
{ "app-plus": { "distribute": { "ios": { "bundleIdentifier": "com.yourcompany.appname" } }, "push": { "unipush": { "enable": true } } } } - 别漏掉
push模块启用:如果modules下没显式声明"push": {},即使unipush.enable为 true,云打包也会忽略推送能力
常见静默失败原因(无报错但收不到通知)
这类问题最耗时间,因为控制台和日志都显示“配置成功”,实际链路在某处断了。
- iOS 设备未开启通知权限:
uni.getProvider返回apns成功 ≠ 设备允许通知,必须调用uni.authorize({scope: 'scope.notification'})并引导用户手动开启 - 测试时用了开发版 profile 却配了生产环境
p8:苹果不区分环境,p8本身是环境无关的,但你打包时用的mobileprovision文件必须匹配 App ID 的推送开关状态(即:若 App ID 开的是 Production Push,则 profile 必须是 Distribution 类型) -
Bundle ID在苹果后台、manifest.json、DCloud 控制台三处不完全一致:比如多了一个空格、大小写混用(com.MyApp≠com.myapp),这种差异不会报错,但 APNs 拒绝路由
真正卡住人的从来不是“怎么点按钮”,而是这三处 ID 是否咬死对齐、权限是否真实授予、profile 是否与推送开关类型匹配——这些细节不验证,光上传 p8 文件毫无意义。










