想让“海王出海”图标显示未读提醒，核心在于三点：系统允许角标、应用有准确的未读计数并在合适时机更新、以及兼容不同平台与手机厂商的差异。作为用户，你要在系统通知设置里打开“角标/通知点”；作为开发者或产品方，要把未读计数在服务器上维护并在用户登录或收到推送时同步（iOS 用 APNs 的 badge 字段，Android 多靠通知数字或第三方库/厂商推送实现），并处理后台限制、电池优化与权限问题。下面按“用户步骤”“开发实现”“厂商差异”“排查清单”逐条拆解，给出可操作的检查项与解决办法，方便马上验证和修复。
先弄清楚这事儿到底是什么（用一句话与一个比喻）
概念：“图标未读提醒”（也叫角标、badge、notification dot）是展示在应用图标上的小数字或红点，用来提示用户应用内有待处理的消息或未读项。
比喻：把应用图标想成一扇门，角标就是门上的便签：有便签就说明屋里有事要你看。如果便签不见了，可能是门钥匙（系统权限）没给你，或者你本来就没写便签（应用没有维护计数），还有可能是便签被风吹走了（厂商或系统拦截了推送）。
第一部分：普通用户一步步要做的事（最先尝试）
通用步骤（iOS 与 Android 的第一轮检查）
- 打开系统通知权限：进入系统“设置”→“通知”→找到“海王出海”，确保“允许通知”已开启。
- 启用图标角标/未读提醒：在同一页面内开启“角标”（iOS）或“允许图标角标/应用角标”（Android，不同厂商名称不同）。
- 确认应用内通知设置：打开应用内设置，确认“消息推送/未读提醒/角标”相关开关已打开。
- 网络与登录：确保应用已登录且能正常联网，角标数字常由服务器下发或在登录后同步。
iOS（iPhone / iPad）用户设置路径
- 设置 → 通知 → 找到“海王出海” → 打开“允许通知”和“标记（Badge）”。
- 如果仍然不显示，尝试重启手机或卸载重装应用（注意重装会影响本地数据）。
- 如果只在解锁后才显示，检查是否启用了“勿扰模式”或“推送静默”等限制。
Android 用户设置路径（通用）
- 设置 → 应用 → 找到“海王出海” → 通知 → 打开“允许通知”，并确认是否有“角标/应用图标角标/通知点”。
- 不同 Android 机型或桌面会使用不同术语，找不到时可以在设置里搜索“角标”“图标角标”“通知点”等关键词。
- 确保没有开启电池优化/后台限制，否则应用在后台无法同步未读计数。
针对常见中国品牌手机（用户侧特定操作）
- 小米（MIUI）：设置 → 应用 → “海王出海” → 权限 → 确认“允许通知”“显示角标”都开启，同时在“系统应用设置”或“桌面与最近任务”中允许“显示徽章/角标”。
- 华为（EMUI）/荣耀：设置 → 桌面和壁纸设置 → 开启“图标角标”，并在应用通知内允许通知和角标。还要检查“手机管家”里的自启动和通知管理。
- OPPO / Vivo / Realme：设置 → 应用管理 → 找到应用 → 通知 → 开启角标/通知摆放权限，并允许自启动或后台运行。
- Samsung：设置 → 通知 → 应用图标徽章，检查是否允许以及是数字还是点。
第二部分：开发者或产品方如何实现（从服务器到设备）
实现角标的关键思想：未读计数必须有“唯一的来源”（通常在服务器端），客户端定期或在关键时刻从服务器同步这个计数，并把计数反映到系统角标上。推送仅是把计数“下发到设备”的一种机制，但不能依赖推送在所有环境稳定工作，因此要有本地同步逻辑。
总体流程（端到端）
- 在服务器端维护每个账号的未读计数（例如消息、订单、系统通知等合并逻辑）。
- 当未读计数变化时：通过推送服务把最新计数下发给设备，同时在用户打开应用或应用进入前台时从服务器拉取并校验计数。
- 客户端接收到计数后：更新本地存储，刷新界面内未读、并将计数写入系统角标（iOS 或 Android）。
- 当用户在任何设备上清空或阅读时：向服务器提交同步请求，服务器更新计数并通知其他设备下发最新计数。
iOS 实现要点（App 端）
- 请求通知权限时，确保请求了 badge 权限：
UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound])
- 通过 APNs 下发角标：APNs payload 中的 aps.badge 字段会让系统设置角标。例如：
{“aps”:{“alert”:”你有新消息”,”badge”:5,”sound”:”default”}}
- 本地设置角标：应用可以在任何时刻使用 UIApplication.shared.applicationIconBadgeNumber = n 来设置或清零角标（例如用户手动清阅）。
- 注意事项：
- iOS 的角标是由系统呈现，只有数字（或清零）。
- APNs 的 badge 优先级：APNs payload 中的 badge 会覆盖本地设置；视业务优先级选择主控方（服务器优先或客户端优先）。
- 若用户关闭了角标权限，应用无权显示角标，需引导用户到设置页面开启。
Android 实现要点（App 端）
Android 长期以来没有统一的“角标 API”，从 Android 8.0（Oreo）开始引入了“通知角标（notification dots）”机制，但厂商桌面行为差异仍然存在。
- Android 8.0+：
- 使用 NotificationChannel.setShowBadge(true/false) 来控制渠道是否显示角标。
- 调用 NotificationCompat.Builder.setNumber(int) 或 Notification.notification.number 来建议显示的数字（不同 launcher 展示方式不同）。
- 低版本与厂商桌面：
- 需借助第三方库（如 ShortcutBadger）或厂商推送 SDK（小米推送、华为 HMS、OPPO 推送等）来设置角标数字。
- 不同厂商支持不同的 Intent 或反射 API，维护成本高，推荐使用成熟第三方库或厂商统一推送 SDK。
- Firebase Cloud Messaging（FCM）：
- FCM 的通知消息在安卓端通常只显示通知，不统一管理角标数字；要实现数字角标，通常需要在推送的 data 字段写入未读数，由客户端接收并调用 ShortcutBadger 或更新本地通知数字。
推送服务与角标：谁发数谁负责？
最佳实践：把“未读计数”作为服务器的权威数据源；当计数变动时，服务器同时发推送和保存状态。推送的 payload 包含最新计数，客户端收到后直接写入系统角标；若推送丢失或被系统拦截，客户端在启动时主动从服务器拉取最新计数并同步。
| 角色 | 职责（关键点） |
| 服务器 | 维护未读总数、下发推送（含 badge 值）、为客户端提供查询接口 |
| 客户端（App） | 请求通知权限、接收推送更新角标、前台同步与用户操作上报 |
| 系统/桌面 | 控制是否展示角标、如何展示（数字/红点）及是否允许后台行为 |
第三部分：常见问题与逐项排查（遇到不显示时按这个顺序）
如果角标不显示或数字不准确，按以下清单逐项排查，从简单到复杂。
- 第一步：用户权限检查 — 系统通知、角标是否被关闭？若关闭，引导用户开启。
- 第二步：网络与登录 — 应用是否处于登录状态？能否跟服务器通信？
- 第三步：后台限制/省电策略 — 手机是否限制应用后台网络或自启动？（MIUI/EMUI/ColorOS 常见）
- 第四步：推送是否到达 — 在服务器发送推送后，设备是否收到？使用推送控制台查看送达/点击率日志。
- 第五步：客户端写角标是否执行 — 应用是否在收到推送或同步接口后调用了角标设置接口？（iOS: applicationIconBadgeNumber；Android: NotificationCompat.setNumber 或 ShortcutBadger）
- 第六步：多设备/多端同步问题 — 在另一台设备上清空未读但本设备未同步，需确保服务器推送清零并客户端在 foreground 时拉取最新计数。
- 第七步：厂商桌面兼容 — 有些厂商或第三方桌面不支持数字，仅显示红点，或只支持厂商推送下发角标；需做兼容说明。
一些实际排查方法
- 在 iOS 上用 APNs 测试 payload，确认设备是否将 badge 设置为期望值。
- 在 Android 上通过 log 或调试断点确认接收推送后是否调用了写角标的代码路径。
- 记录并对比服务器下发的数据与设备存储的数据，定位差异发生在哪一环。
- 使用厂商提供的调试工具 / 控制台查看消息下发状态（例如小米、华为推送控制台）。
第四部分：厂商差异与注意事项（你不得不知道的坑）
移动厂商自定义系统与桌面会导致角标行为差异，常见的坑包括：
- MIUI：需要“显示角标”权限，有时需解除应用的电池优化和允许自启动才能稳定接收推送。
- EMUI（华为）：角标依赖系统桌面开关，且对后台行为限制严格，推荐使用华为推送与 HMS 支持。
- OPPO / Vivo：推送投递与桌面支持不统一，有时需要厂商推送SDK方可稳定显示角标。
- 第三方桌面（如 Nova、GO Launcher）：角标显示可能依赖插件或额外设置。
- Android 各版本差异：Oreo 以上系统原生支持通知角标，但只显示“点”或以“通知数”形式汇总，显示行为由 Launcher 决定。
第五部分：实用清单与建议（给产品/开发/运维的操作手册）
这里把实现角标的关键步骤做成一份可执行的清单，便于团队逐项完成。
- 服务器端
- 在用户模型或消息服务中维护未读总数接口（REST / gRPC）。
- 当未读数变化时：触发下发推送（包含计数）并记录推送日志与返回状态。
- 提供设备同步接口（比如 /notifications/unread_count），并记录客户端最后同步时间。
- 客户端（iOS）
- 请求并检测 badge 权限；用户关闭时提供引导入口跳转到设置页。
- 接收 APNs badge 字段并写入 applicationIconBadgeNumber；在 app 启动/进入前台时拉取最新计数并覆盖本地角标。
- 用户手动阅读或清空时，调用服务器接口并同步清零角标。
- 客户端（Android）
- 对 Android 8.0+ 使用 NotificationChannel.setShowBadge 并在构建通知时 setNumber。
- 对低版本和厂商桌面使用 ShortcutBadger 或厂商 SDK 来设置角标。
- 处理电池优化与自启动策略，必要时在首次启动时弹窗提示用户允许相关权限。
- 运维/监控
- 监控推送送达率、打开率与角标同步失败率。
- 设置报警：推送送达率低于阈值或用户大量反馈角标异常时触发运维介入。
第六部分：常用第三方工具与库（快速集成参考）
- 推送服务
- APNs（Apple Push Notification service）— iOS 通用推送。
- Firebase Cloud Messaging（FCM）— Android / iOS 的跨平台推送基础（注意 FCM 的通知消息在 Android 上通常不包含角标字段，需要自定义 data 并让客户端处理）。
- 国内厂商推送：极光（JPush）、小米推送、华为推送、OPPO/ VIVO 推送 — 这些 SDK 对各自设备的角标支持通常更好。
- 角标库
- ShortcutBadger（Android）— 适配多个厂商桌面的第三方库（社区维护，需注意版本兼容）。
- 注意：选择 SDK/库时注意开源维护情况和与目标用户机型的兼容性测试。
实操示例（简要伪代码，帮助理解流程）
下面只是为了说明流程，具体代码请按你项目语言与 SDK 文档实现。
- iOS：接收 APNs 后端点示例：
服务器推送：{“aps”:{“alert”:”新消息”,”badge”:7}}
客户端：在 didFinishLaunching 或通知回调中，读取远端 badge 并执行 UIApplication.shared.applicationIconBadgeNumber = badgeValue
- Android（简化思路）：
- 服务器下发：data payload { “unread”: 7 }
- 客户端收到 data：更新本地未读并尝试
NotificationCompat.Builder.setNumber(7)，
并对低版本调用 ShortcutBadger.applyCount(context,7)
最后一点建议（别等用户投诉再修）
角标看似小功能，但对消息类/社交/电商产品的留存与响应率有显著影响。务必把角标当作一个端到端功能来设计：从服务器设计到客户端 UX，再到运维监控都要落地。上线前在目标机型/桌面上做充足的兼容性测试，尤其是国内主流机型的省电策略和厂商推送行为。
好吧，事情大致就是这样。你可以先按上面“用户步骤”把手机的通知和角标打开，再让开发同学验证服务端有没有把正确的计数下发；如果都确认无误，但在某些机型仍然抖脚（不稳定），通常是厂商桌面或省电策略的锅，那就要按厂商提供的 SDK 做深度兼容了。我这边想到的常见问题和解决办法都放在本文里，按清单一项项对就行，遇到具体机型还可以把设备机型、系统版本和日志贴出来再一起定位。