同一个 App,五种手机五种死法:2026 年 Android 五大 ROM 兼容的 8 个真实坑

2 阅读40分钟

起因:一个查不出原因的空指针

去年 11 月,我们收到运营转来的投诉:"健康南京 App 在部分安卓手机上打开就闪退。"

第一反应是版本问题。查崩溃日志,Bugly 上写着:

java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.String com.xxx.util.DeviceInfo.getChannel()' on a null object reference

机型分布:华为 Mate 60、小米 14、OPPO Find X7、vivo X100、荣耀 Magic6 —— 五家全中。

我第一反应是"我们代码写错了"。于是老老实实排查代码,找了三小时,什么也没找到。

后来一个老同事说了一句:"这五个型号是不是都是最新的?都是刚升级过系统?"

我愣了一下,翻了崩溃日志的设备信息版本号。全是各家最新推送的 ROM。

这就是我要讲的第一件事:**在国产 Android 上,"某个机型偶发问题"的第一嫌疑不是机型,是那个机型上刚推的某次系统更新。**五家厂商各自更新,五家都崩了同一个空指针——这不可能是五个独立 bug,它是一个共性问题被五个系统同时放大了。

根因后来查出来了:五家新 ROM 都改了 Application 初始化时的 Provider 加载顺序,我们有个第三方 SDK 在 ContentProvider 的 onCreate 里读了渠道信息,而渠道信息要等 Application.onCreate 之后才由我们的另一个初始化器写入。在旧 ROM 上这个顺序恰好是对的,新 ROM 全改成了错的。

这个坑教会我一件事:国产 Android 兼容,本质上不是"适配 5 个厂商",是"适配 5 套生命周期哲学"。


先把底层模型说清楚,否则后面全是玄学

在做任何具体适配之前,得先建立一个认知框架。**杀你 App 的不是一个东西,是三层叠加。**很多团队只处理第一层,然后被第二三层反复打脸。

第 1 层:Android 系统的省电机制(Doze / App Standby)
        所有厂商都有,行为可预测,能用 WorkManager / AlarmManager 绕
                ↓
第 2 层:厂商的电池与进程管理(各家策略完全不同,且随版本变)
        这层才是真正的战场:无预警杀进程,无回调,无日志
                ↓
第 3 层:厂商的应用分发与合规体系(后台定位、关联启动、二级权限开关)
        这层不是系统行为,是"许可",用户不给你就直接不能用

再叠加一个贯穿三层的因素:国内没有 GMS。你在网上看到的所有"海外最佳实践",只要依赖 FCM、Play Services、Firebase,在国行设备上全部要换实现。这不是可选项。

还有一件事必须说清楚:**华为/荣耀已经是一个独立目标平台了。**HarmonyOS NEXT / HarmonyOS 5 上,应用是原生鸿蒙包(ArkTS + ArkUI),不是 APK。华为文档(2026-05-27 更新)写得很明确:NEXT 应用全球仅对智能手表开放,其他设备类限于中国大陆。老机型(EMUI 及更早)还有 Android 兼容层,新机型没有了。

所以"兼容华为"这句话,在 2026 年必须拆成两个完全不同的项目来做。

带着这个框架,我们逐个看坑。


坑 1:后台进程被杀——五个厂商,五种死法

现象

用户反馈通常是模糊的:"App 放后台一会儿,再打开数据没了""消息收不到""同步不动了"。

我们按品牌统计过一次线上反馈,结论很扎心:

厂商死亡方式典型存活时间有无回调
华为 / 荣耀"应用启动管理"里的自启动/关联启动被系统默认关掉息屏后 1–2 分钟无
小米 / Redmi自启动 + 关联启动 + 电池策略"智能"三选一息屏后 30 秒 – 3 分钟无
OPPO / 一加"智能冻结"直接杀后台 Service,连前台服务一起息屏后 1–3 分钟无
vivo / iQOO后台高耗电管理 + startForegroundService 拦截不定,随机无
原生 AndroidDoze / App Standby 桶降级小时级有

为什么厂商要这么做

这是所有兼容文章里最少讲、但最重要的一段。

厂商的出发点不是"针对你的 App",是整机续航和跑分。手机厂商卖的是硬件,用户拿同款 OPPO 和别家对比续航,差 5% 就影响销量。为了这个目标,系统层必须做两件事:

  1. 尽可能多地冻结后台进程,省内存、省 CPU、省电。
  2. 让"用户主动允许"成为唯一的后台存活路径——因为用户点了"允许",出问题用户不会来找厂商投诉,厂商也没有理由再激进。

所以你会看到一个反直觉的现象:**厂商的策略越激进,官方文档越含糊。**因为它本质上是"防你(开发者)偷电",而不是一项对外承诺的特性。你去翻小米的开发者文档,是找不到"自启动管理会杀你的 App"这条的。

理解到这一层,很多"bug"就变成了"预期行为"。你不能去说服系统,你只能去申请权限,或者绕开它。

我们的处理过程

第一步是建立 ROM 识别层。我们写了 RomDetector,不靠 Build.MANUFACTURER(这个在荣耀上返回的是 "HONOR" 还是 "HUAWEI"?在小米海外版上又是什么?),而是靠系统属性:

object RomDetector {
    fun getRomType(): RomType {
        // 小米
        getSystemProperty("ro.miui.ui.version.name")?.let {
            return RomType.XIAOMI
        }
        // 华为
        getSystemProperty("ro.huawei.build.display.id")?.let {
            return RomType.HUAWEI
        }
        // OPPO
        getSystemProperty("ro.build.version.opporom")?.let {
            return RomType.OPPO
        }
        // vivo
        getSystemProperty("ro.vivo.os.version")?.let {
            return RomType.VIVO
        }
        // 荣耀(独立判断,不能并入华为)
        getSystemProperty("ro.build.version.honor")?.let {
            return RomType.HONOR
        }
        return RomType.OTHER
    }
}

注意"检测系统属性而不是包名"——这是我们踩过坑之后改的。早期我们用 Build.MANUFACTURER == "Xiaomi" 判断,结果在小米澎湃 OS 的某些定制版本上返回空值,判断全错。而 ro.miui.ui.version.name 这类系统属性稳定得多。

第二步是每家一套独立的引导流程。这里有个硬约束:不能指望一套逻辑通吃。

  • 华为:跳 com.huawei.systemmanager 的 startActivityForResult 到"应用启动管理"页,让用户手动开"自启动 / 关联启动 / 后台运行"三个开关。华为的 isIgnoringBatteryOptimizations 检测必须在 Activity 上下文里调用,用 Application 上下文会返回不准。
  • 小米:跳 com.miui.securitycenter 的 com.miui.permcenter.permissions.AppPermissionsEditorActivity,带上 extra_pkgname。必须用 startActivityForResult,用现代的 ActivityResult API 反而拿不到结果——这是小米特有行为。
  • OPPO:ColorOS 12+ 对 ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS 这类通用 Intent 会拦截,需要用厂商私有 Intent 兜底。
  • vivo:startForegroundService 会被拦,日志出现 Not allowed to start service,得换 startService + Service.startForeground() 的组合。

第三步是别把保活当唯一解。我们最终的方案是:放弃"进程永远活着"这个执念,改成"进程死了也能恢复"。

具体做法是三件事:

  1. 所有状态持久化到本地,进程被杀不丢数据(这个本来就是必须的,很多团队却栽在这)。
  2. 所有关键操作用幂等设计,重复执行不会产生脏数据。
  3. 用 WorkManager + AlarmManager 兜底,而不是自己写 while(true) 循环 + startService 拉活。

第三点我们要特别强调一个反直觉的经验:**很多网上的"保活方案"(Cactus、双进程守护、JobScheduler 无限循环)本质是在跟系统对抗,对抗的代价是功耗、耗电、ANR 率、审核风险。**我们实测过,一台小米手机上跑双进程守护,24 小时额外耗电 11%–14%,而且在系统更新后随时可能失效。

真正靠谱的保活只有一条:把需要后台执行的活,交给系统认可的执行器(厂商通道推送、WorkManager、AlarmManager),然后把用户引导做到位。

经验分享

后台保活这件事,我们的认知经历了三个阶段:

阶段一:以为有通用方案 → 搜了一堆开源库 → 每家都失效。 阶段二:以为靠引导用户设置就能解决 → 发现引导页的转化率只有 3%–7%,而且用户随时会被系统重置回去。 阶段三:接受"会被杀"是常态,把架构改成"被杀也能活"。

现在我们上线一个需要后台能力的功能(比如健康数据定时同步、用药提醒),流程固定是三步:

  1. 能不能用推送唤起? → 能,就别保活,用厂商通道推。
  2. 不能推,但可以用系统调度器? → 用 WorkManager + setRequiredDelay,配合 AlarmManager.setExactAndAllowWhileIdle 做兜底。
  3. 都不行(必须常驻,比如蓝牙采集)? → 这时候才做前台服务 + 引导用户加白名单。

**顺序不能反。**我们见过太多团队一上来就搞双进程守护,其实业务上根本用不着。

还有一个容易忽略的:**引导用户加白名单之后,必须验证它真的生效了。**用户在小米的"电池"里选了"无限制",不代表"自启动管理"里的开关也开了。这两个是独立的开关。华为的"应用启动管理"更是三个独立开关。

我们的自检脚本是这样的逻辑:加完白名单后,让 App 息屏 30 分钟,然后主动查一次本地数据的更新时间戳——如果没更新,说明白名单没生效,而不是"服务有问题"。

这个自检脚本救了我们至少 3 次线上事故。


坑 2:推送通道——最贵的一个坑

现象

用户:"预约提醒收不到。" 开发:"我本地测收到了啊。" 运营:"小米用户反馈特别多。"

这是典型的测试环境给你假象。你在自己手机上测,App 在前台,长连接活着,推送秒到。用户锁屏 5 分钟,进程死了,长连接断了,消息永远到不了。

为什么会这样

推送的链路是这样的:

你的服务端 → 推送平台 → 设备

如果走第三方推送(极光、个推、友盟、腾讯信鸽),中间这层靠的是一条你自己 App 进程维持的 TCP 长连接。App 进程死了,连接断了,服务端找不到设备,消息丢弃。

如果走厂商通道(华为 HMS Push / 小米 MiPush / OPPO Push / vivo Push / 荣耀推送 / 魅族推送),消息是由系统进程代收代发的,跟你的 App 进程活不活没关系。

**这就是全部差异。**一句话:厂商通道是系统帮你送,第三方通道是你自己送。

行业里流传的经验值是:没接厂商通道,国行 ROM 上到达率 30%–60%;接齐之后 90%+。(这是长期工程实践的统计,不是官方承诺,具体数字各家 SDK 和业务形态差异很大,但量级是靠谱的。)

另一个关键事实:**FCM 在国内是不可用的。**即使你的客户端集成了 Firebase Messaging,服务端在境内根本连不上 FCM。所以"用 FCM 一套打通全球"这个方案在国内场景下,海外能用、国内直接死。

我们的处理过程

第一次接厂商通道时,我们踩了三个非常典型的坑:

坑 A:包名/签名不一致,token 永远注册不上。

各厂商 SDK 都需要你在自己的开发者后台建应用,填的包名和签名证书指纹必须和最终打出来的 APK 完全一致。我们测试包用 debug 签名、正式包用 release 签名,导致华为的 HMS token 在正式包上永远拿不到,SDK 回调里只给一个"获取 token 失败"和错误码,不给具体原因,非常难查。

这一条后来我们做成了构建期校验:Gradle 脚本里自动读取当前变体的签名指纹,和各厂商后台配置做比对,不一致直接让构建失败。这个检查救过我们不止一次。

坑 B:第三方聚合推送的"总开关"没打开。

我们用极光推送做统一通道,极光支持代发各厂商通道。但极光后台必须手动配置好各厂商的 AppKey / Secret,配漏一个,那家设备就是死的。症状特别隐蔽:极光控制台显示"发送成功",因为对极光来说确实成功了——但它只是把消息投给了厂商通道,厂商通道因为 AppKey 不对直接拒收。

排查这类问题有个技巧:**看厂商 SDK 的回调日志,而不是看推送平台的状态。**极光的"成功"不代表送达。

坑 C:通知权限与渠道(Channel)的静默失败。

Android 8.0+ 通知必须绑定 Channel,没有 Channel 的通知直接不显示;Android 13+ 必须运行时申请 POST_NOTIFICATIONS,用户拒绝后通知静默丢弃,没有回调。我们在小米上见过同一个 App,测试机(Android 12)正常,用户机(Android 14)完全收不到——就是权限没申请。

还有一个更阴的:**部分厂商 ROM 有"通知智能管理/免打扰",会在锁屏后自动折叠通知甚至延迟投递。**用户去设置里看一眼就全明白了,但这需要在引导文案里说清楚。

我们最终的推送架构

┌─────────────────────────────────────────────┐
│  消息分级(不是所有消息都走推送)               │
│   L1 强时效(预约提醒、急诊通知)→ 必走厂商通道   │
│   L2 一般时效(健康报告生成完成)→ 厂商通道 + 拉取 │
│   L3 非时效(活动推荐、营销)→ 避免打扰用户       │
└─────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────┐
│  通道路由(按 token 类型分发)                   │
│   华为 token  → HMS Push API                  │
│   小米 token  → MiPush API                    │
│   ...                                        │
│   其他 token  → 第三方长连接                    │
└─────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────┐
│  降级链                                         │
│   厂商通道失败 → 第三方通道 → App 启动时拉取      │
│                → 极端情况:短信(仅 L1)          │
└─────────────────────────────────────────────┘

最后那条"短信兜底"是给 L1 消息准备的。医疗健康类 App 的预约提醒、用药提醒漏一条,可能就是一次真实的健康事件。为了这一条消息付一条短信的钱是值得的,但只能给 L1 用——如果所有消息都短信兜底,用户会直接卸载。

经验分享

厂商通道的维护成本被严重低估了。

集成是一天的事,维护是三年的事。每年各家 SDK 都会升级、要求新的配置、修改 token 的获取方式。而且五家厂商的文档质量参差不齐,小米和 OPPO 的文档经常写着"详见官方文档"。

我们现在的做法是:写一个统一的 PushChannel 抽象层,业务层只认 PushChannel.send(msg),各家 SDK 的差异全部封在适配器里。适配器接口统一成三个方法:register()、getToken()、send()。这样升级某一家 SDK 时,改动只在一个文件里。

还有一个容易忽略的点:**token 会失效,需要定期刷新和重新上报。**我们见过某个用户换了手机之后,服务端还在往一个死 token 上发消息,白白消耗配额。设备重置、用户登出、系统升级都可能让 token 变。


坑 3:悬浮窗 / 后台弹窗权限——三重门校验

这个坑的隐蔽程度排第二,但排查难度排第一。

现象

W/WindowManager: Permission denied for window type 2002

或者用户说:"悬浮窗刚打开就没了"、"点通知进 App 弹不出登录框"。

为什么这么难

因为 Settings.canDrawOverlays(context) 返回 true,不代表你真的能弹。厂商在这之上又加了两道门:

层级校验内容怎么过
系统级canDrawOverlays()跳 ACTION_MANAGE_OVERLAY_PERMISSION
厂商级ROM 私有的二级开关跳厂商私有设置页 + 引导用户手动开
运行时真正 addView 时会不会被拦无解,只能试

第二层是最麻烦的。小米要求三个开关同时打开:显示悬浮窗、自启动、电池优化白名单,缺一不可。vivo 的 startForegroundService 被拦截、OPPO 的"智能冻结"杀 Service,都发生在这一层。

第三层是最坑的:**MIUI 有个特殊逻辑——即使你有悬浮窗权限,如果用户已经把你从最近任务列表里划掉了,MiuiWindowManagerService 依然会拦截你的 WindowManager.addView。**日志里只有那行 Permission denied for window type 2002,没有任何其他线索。

很多团队在这里会得出一个错误的结论:"小米有 bug"。不是小米有 bug,是小米在明确表达一个产品决策:你不该在用户已经"关掉"你的情况下继续弹窗。

我们的处理过程

我们放弃了"一次检测 + 一次跳转"的思路,改成三阶检测法:

// 阶 1:系统级
val systemGranted = Settings.canDrawOverlays(context)

// 阶 2:厂商级(反射读厂商私有 Provider)
fun isMiuiOverlayGranted(): Boolean {
    return try {
        val uri = Uri.parse("content://miui/permission/overlay")
        context.contentResolver.query(uri, null, null, null, null)
            ?.use { it.moveToFirst(); it.getInt(0) == 1 }
    } catch (e: Exception) { false }
}

// 阶 3:运行时(实际试一次最小窗口)
fun canRealAddOverlay(): Boolean {
    return try {
        val view = View(context).apply { setBackgroundColor(Color.TRANSPARENT) }
        val params = WindowManager.LayoutParams(
            1, 1, WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY, FLAG_NOT_FOCUSABLE, FLAG_LAYOUT_NO_LIMITS
        )
        wm.addView(view, params)
        wm.removeView(view)
        true
    } catch (e: Exception) { false }  // BadTokenException / SecurityException
}

第三阶是关键。前两阶是"我猜你允许了",第三阶是"我验证了真的可以"。只要第三阶失败,就说明还有我们没检测到的门,此时必须给用户一个带截图的引导 Dialog,而不是继续假装"已授权"。

引导 Dialog 里要有:当前状态说明 → 具体路径 → 截图 → "我知道了"。我们发现,带截图的引导比纯文字的完成率高 2 倍以上,用户不会在设置页里迷路。

一个必须记住的细节

别在后台 Activity 里创建悬浮窗。华为 EMUI 11+ 的 Overlay 窗口需要绑定前台 Activity Token,从后台 Service 创建会被直接 kill,且无日志。我们曾经排查这个查了一整天,最后是在 ActivityLifecycleCallbacks 里加日志才发现 Service 创建的那一瞬间窗口就被扔了。

正确做法是:把 WindowManager 的 Context 用 applicationContext,但创建时机要在 Activity 可见时,并在 onActivityPaused 时 setVisibility(GONE) 而不是 removeView。

经验分享

这个坑教会我们一件事:权限引导不是 UI 问题,是状态机问题。

我们现在的做法是把每个需要引导的权限建模成一个明确的状态:

未申请 → 已申请未授权 → 系统已授权但厂商未授权 → 完全可用

每种状态对应不同的 UI:没申请过就不弹任何引导(先让用户遇到功能需求时再申请);申请过了但厂商没开,才弹带截图的引导。

**很多 App 的问题是一上来就弹一堆权限引导,把用户吓跑了。**用户拒绝一次之后,你就永远失去这个用户了。


坑 4:WebView 兼容性——内核版本和系统版本是两回事

现象

  • ReferenceError: Promise is not defined
  • SyntaxError: Unexpected token 'const' → async/await 直接语法报错
  • CSS Grid 布局错乱、Flex 渲染异常
  • 登录态莫名丢失,document.cookie 为空
  • Android 14 升级后大批量白屏

为什么

这是最反直觉的一个坑,因为很多人默认"WebView 版本 = 系统版本"。

实际上:Android System WebView 是一个独立的 APK(com.android.webview 或 com.google.android.webview),它通过应用商店单独更新,跟系统升级完全解耦。所以:

  • 一台 Android 15 的手机,WebView 可能是 Chromium 130,也可能是三个月前没更新过的 Chromium 115。
  • 用户从应用商店更新了 WebView,你的 App 行为就变了 —— 你没有发版,用户的行为变了。
  • 华为、荣耀还有自研的 WebView 内核(华为浏览器内核),版本策略跟 Google 的 Chrome 又不一样。

所以你会看到"同一个 Android 版本,不同厂商的 WebView 内核可能差好几个大版本",而同一台机器,隔一个月行为就可能不一样。

我们的处理过程

第一步:不猜,做运行时能力检测。

启动时执行一次探测脚本,把结果存到本地:

(function () {
  var ua = navigator.userAgent;
  var m = ua.match(/Chrome\/(\d+)/);
  return JSON.stringify({
    chromiumVersion: m ? parseInt(m[1], 10) : 0,
    hasPromise: typeof Promise !== 'undefined',
    hasCSSGrid: typeof CSS !== 'undefined' && CSS.supports &&
                CSS.supports('display', 'grid'),
    hasFlex: typeof CSS !== 'undefined' && CSS.supports &&
              CSS.supports('display', 'flex'),
    hasWeakRef: typeof WeakRef !== 'undefined',
    hasIntersectionObserver: typeof IntersectionObserver !== 'undefined'
  });
})()

**用特性检测(feature detection)而不是 UA 嗅探。**UA 字符串可以被伪造、可以被改、也不可靠。我们一开始用 UA 判断华为,结果华为浏览器改了一次 UA 格式,我们就漏判了。

第二步:降级路径要写死在代码里。

// 不依赖 polyfill 的写法:直接用回调,别碰 Promise
function fetchData(url, onSuccess, onError) {
  var xhr = new XMLHttpRequest();
  xhr.open('GET', url, true);
  xhr.onreadystatechange = function () {
    if (xhr.readyState !== 4) return;
    if (xhr.status >= 200 && xhr.status < 300) {
      onSuccess(JSON.parse(xhr.responseText));
    } else {
      onError(new Error('HTTP ' + xhr.status));
    }
  };
  xhr.send();
}

我们团队的规矩是:H5 侧的代码必须能在 Chromium 74 上跑通(这是我们从线上数据统计出来的低端机 WebView 分位线)。这个约束反过来倒逼业务代码不用新语法,比事后加 polyfill 靠谱得多——polyfill 有体积,而且经常在奇怪的边界上出问题。

第三步:Cookie 丢失这个坑单独说。

登录态丢失是投诉里最常见也最难查的一类,因为它"时好时坏"。

我们定位到的原因有几层:

  • 非 HTTPS:Android 5.0+ WebView 默认禁止混合内容,HTTP 页面里嵌 HTTPS 资源(或者反过来)会被拦截。
  • Chromium 版本低:某些老内核的 document.cookie 在跨域场景下读不到 HttpOnly 之外的属性。
  • 厂商定制:部分 ROM 对 WebView 的多进程模型做了改动,导致 CookieManager 在跨进程时出现异常。
  • 第三方 Cookie 策略:Chromium 80+ 默认禁止第三方 Cookie,如果你的登录态依赖第三方域的 Cookie(比如 SSO),在老版本上反而能工作,在新版本上会断 —— 这个很讽刺,但很常见。

我们的解法是:**登录态不放在 Cookie 里。**自己维护一个 token,存到 localStorage 或者通过 JavascriptInterface 传给原生层。这个改造花了我们一周,但之后登录态问题就再没出现过。

第四步:Android 14+ 的 WebView 进程被系统杀。

Android 14 加强了 WebView 渲染进程的管控,用户反馈"Android 14 升级后大面积白屏闪退"。查 /data/data/包名/app_webview/ 下的日志,能看到渲染进程被杀。

我们的处理是两条:

  1. 全部资源走 HTTPS,减少明文流量被中断的概率。
  2. 给 WebView 单独的进程(android:process=":webview"),避免主进程被连带杀掉。这条不是银弹,但能显著降低"整页白屏"变成"整 App 崩溃"的比例。

经验分享

WebView 这个坑的教训是:你永远无法通过测试覆盖它。

因为用户的 WebView 版本是你控制不了的变量。我们的对策是:

  • 维护一个"WebView 能力矩阵",记录线上各 WebView 版本的实际表现,作为功能开关的依据。
  • 核心链路不依赖 H5。预约、挂号、报告查询这类关键流程,能用原生就用原生,H5 只做非关键的富文本。
  • H5 崩溃必须有兜底页。WebView 渲染进程被杀时,父进程会收到 onRenderProcessGone,我们在里面展示一个原生兜底页 + "重新加载"按钮,而不是让用户对着白屏发呆。

最后一条是用户体验上的救命稻草。白屏是绝望,重新加载按钮是希望。


坑 5:隐私合规——审核驳回率最高的重灾区

这个坑跟技术关系不大,但它卡你上线,而且驳回理由经常让你一脸问号。

现象

华为审核驳回,理由写得非常具体:

"在用户同意隐私政策前,您的应用申请获取 XXX"

或者:

"应用启动后立即申请相机权限"

为什么(这里有个反直觉的机制)

按华为官方 2026 年 6 月发布的隐私合规 TOP8 驳回问题解析,排名第一的永远是同一条:在用户同意隐私政策前获取个人信息或权限。

道理是显然的,但你可能没想到它有多隐蔽:

审核侧的自动化日志扫描,是看整个应用进程生命周期的。从进程启动的那一刻起,到用户点击"同意"为止,这段时间里任何读取设备标识、传感器、媒体、文件的行为,都判定违规——不管是你自己写的业务代码,还是第三方 SDK 内部隐式触发的。

这里的关键是"第三方 SDK 内部隐式触发"。

我们踩过的真实案例:一个鸿蒙项目,业务代码完全正确,隐私弹窗也写了,也确认了用户不点同意就进不去首页。但还是被驳回了。注释代码做二分法测试才抓到元凶——EntryAbility 的 onCreate 里初始化了某个系统 Kit,框架在初始化阶段预加载能力、读取了部分设备信息,这一步跑在隐私弹窗之前。

我们自己的代码一行没改,是框架干的。

**还有一个更常见的:统计 SDK。**很多 App 在 Application.onCreate 里就初始化了友盟/极光/神策,SDK 初始化时会上报设备信息。开发者自己没写任何采集代码,但网络请求已经发出去了。

**这解释了一个现象:为什么有些开发者反复被驳回,自己却找不到问题在哪。**因为问题真的不在你写的代码里。

我们的处理过程

第一步:把"同意前"做成一个硬边界。

我们定了铁律:

用户点击"同意"之前,App 就是一个"死的"。没有网络请求,没有设备信息读取,没有第三方 SDK 初始化。

这条铁律的执行方式是把所有 SDK 初始化从 Application.onCreate 挪到一个显式的 PrivacyGate.init(context) 里,只有用户同意后才调用。

class HealthApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 只做不涉及个人信息的最基础初始化
        AppContext.init(this)
        // 注意:这里不做任何第三方 SDK 初始化
    }
}

// 隐私同意后调用
object PrivacyGate {
    fun init(context: Context) {
        AnalyticsTracker.init(context)      // 统计
        PushManager.init(context)            // 推送
        CrashReporter.init(context)         // 崩溃
        // ...
    }
}

第二步:把间接依赖也查出来。

这是最容易漏的一环。你在 build.gradle 里显式声明了 5 个 SDK,但传递依赖可能又带进来 8 个。你需要:

  1. 把所有 build 配置和依赖文件翻一遍
  2. 跑 ./gradlew :app:dependencies 拿到完整的依赖树
  3. 逐个查每个 SDK 的隐私说明文档,确认它收集什么数据
  4. 和隐私政策逐条对照

我们把这个过程做成了 CI 脚本,每次发版自动跑,输出"本次版本引入的 SDK 及其数据采集声明",跟上一版做 diff。新增 SDK 没有对应隐私声明,CI 直接失败。

**这一步经常有惊喜。**我们曾经发现一个图片加载库(AAR 形式引入)内部埋了统计模块,App 里完全没感知。

第三步:注意 SDK 升级也会改变采集行为。

同一个 SDK 的不同版本,采集的数据可能不一样。升级 SDK 之后要重新核对隐私说明。我们把"SDK 升级"和"隐私政策复核"绑成了同一个 checklist 项,不更新就不能合。

经验分享

隐私合规这件事,本质是"举证责任在你"。

审核员是自动化扫描 + 人工抽查。你要做的不是"证明我没问题",而是"让扫描器扫不出问题"。

华为官方提供了三个自检工具,建议都用上:

  • AppAnalyzer 上架前体检(DevEco Studio 6.0.0 Beta1 起提供,6.1.0 Beta1 加了合规体检)
  • AGC 软件包管理的合法性检测:上传包后自动跑,结果分"已达标 / 待优化 / 不通过"三档,"不通过"直接不让提交
  • 手动启动的"上架自检"

但要清楚这些工具的边界:它们能扫出来的都是硬伤,真正让人点驳回的往往是工具扫不出来的东西。

还有一条容易忽略的:**用户拒绝授权后,不要立刻反复弹窗。**正确做法是降级提示:"需要相机权限才能拍照,您可以在设置中开启",让用户自己决定。反复弹窗不仅体验差,审核也会认为是骚扰。


坑 6:五家应用商店,五个审核标准

这个坑不产生崩溃,但直接卡你的上线节奏,而且改起来很磨人。

现象

同一个 APK:

  • 华为应用市场:驳回
  • 小米应用商店:通过
  • OPPO / vivo:要求补材料
  • 应用宝:要求提交安全检测报告

各家的差异(2026 年)

华为应用市场

  • 软著核验最严格:名称、主体、版本必须完全匹配
  • APP 备案核准号 + ICP 备案号双字段强制填写
  • 纯净模式会校验未备案 App,未备案的安装直接拦截
  • 社交、资讯类强制提交安全评估报告
  • 常规应用审核时效通常 24 小时,复杂应用会延长

小米应用商店

  • 三证统一硬性标准:软著名称 = APP 备案名称 = 商店上架名称,差一个字就驳回
  • 版权授权材料审核最严,授权书必须写明包名、有效期、盖章
  • 电商、付费类目要 ICP 许可证的扫描件 + 原件照片

OPPO / vivo 应用商店

  • 规则高度一致:软著、ICP 备案、APP 备案三证齐全才允许提交审核
  • 广告、付费、社区类人工核验 ICP 许可证,无证件直接打回,不进入机检
  • 隐私政策会人工抽查网页可访问性 —— 你的隐私政策网页打不开,直接驳回

应用宝(腾讯)

  • 额外要求应用安全检测报告(后台可自助检测导出)
  • 多商户商城必须同时上传 ICP + EDI
  • 小程序联动的 App 额外核验小程序备案信息

共同门槛(这几条一踩一个死)

  • 软件著作权:安卓全渠道强制
  • 工信部 APP 备案:安卓硬性准入,苹果中国区没这项
  • 经营性 ICP 许可证:只要含会员充值、付费解锁、虚拟打赏、平台广告、付费课程、商家入驻,五大商店均要求,无证直接下架
  • 多商户商城额外要 EDI 许可证
  • 行业专项资质:医疗问诊要《互联网药品信息服务资格证》,金融要对应牌照,直播要文网文,游戏要版号,AI 应用要算法备案,收集人脸/大量信息要做等保二级

我们的处理过程

我们把资质做成了一张五渠道差异对照表,放在项目 wiki 的第一页。每次提交前对着过一遍。

这张表长这样(简化版):

检查项华为小米OPPO/vivo应用宝
软著名称+主体+版本全匹配与备案名/上架名三证统一必须有必须有
APP 备案号必填必填必填必填
ICP 备案号必填必填必填必填
ICP 经营许可证有付费/广告则要同同同
EDI多商户要多商户要多商户要多商户要
安全评估报告社交/资讯类要——一律要
隐私政策网页可访问可访问人工抽查可访问性可访问
纯净模式校验校验未备案会拦截———

这个表的价值不在于一次性做对,而在于把"被驳回"从"意外"变成"可预期"。

我们还把提交材料做成模板化——每次版本更新,隐私政策页面的版本号、SDK 清单、权限清单是自动生成的,人工只核对差异。手工维护这些材料是典型的"忙的时候少改一行",然后被驳回。

经验分享

在应用商店这件事上,最反直觉的一条是:不要追求一次提交通过,要追求"驳回原因可预测"。

我们统计过自己 2025 年的驳回记录:

  • 67% 是材料问题(名称不一致、缺材料、网页不可访问)—— 这类是可以完全消除的
  • 23% 是隐私合规问题—— 其中一半是第三方 SDK 引起的
  • 10% 是内容/功能描述不符

**67% 的驳回是"低级错误",不是"审核严格"。**我算过,如果把材料这一块做成模板和 checklist,那 67% 直接归零。


坑 7:Intent 广播拦截与厂商 SDK 的内部行为

这个坑的特点是:你完全不知道它存在,直到某天所有厂商一起出问题。

现象

我们线上有个"健康数据同步"功能,用 BOOT_COMPLETED 广播在开机后拉取数据。在原生 Android 和早期 ROM 上一直好好的,某天用户反馈:五家手机的这个功能同时失效了。

为什么

原因有两个,都很隐蔽。

第一个原因:厂商在收紧隐式广播。

Android 8.0 之后,隐式广播大部分被限制。厂商又在此基础上加了自启动白名单——即使你声明了 <receiver>,系统也不允许你的 App 在开机时被拉起。

小米有明确的策略:部分关键 Intent 广播会被拦截,你的 receiver 根本收不到。

第二个原因:厂商 SDK 的初始化顺序。

前面那个空指针崩溃,根因就是 ContentProvider 的 onCreate 早于 Application.onCreate。而这在 Android 的官方文档里是明确写过的——ContentProvider 的初始化早于 Application。但很多第三方 SDK 不知道(或者知道但没做处理),它们在 ContentProvider.onCreate 里读渠道信息、读设备 ID。

五家新 ROM 各自调整了 Provider 的加载策略或增加了自己的 Provider,正好把这个顺序问题暴露了出来。

我们的处理过程

针对广播被拦:

我们放弃了"靠 BOOT_COMPLETED"这个方案,改成了三重触发:

  1. BOOT_COMPLETED(可能失效,作为兜底之一)
  2. 应用启动时检查本地数据的最后同步时间,超过阈值就补一次(最可靠)
  3. 厂商通道推送下发一个"该同步了"的自定义消息(最及时,且不受进程存活影响)

第 2 条是关键。不要依赖"系统会叫我",要依赖"我启动时先看看有没有欠账"。

我们把这个模式抽成了一个通用的 SyncScheduler:

object SyncScheduler {
    fun onAppStart() {
        val last = PreferenceStore.lastSyncTime
        if (System.currentTimeMillis() - last > SYNC_INTERVAL) {
            SyncWorker.enqueue(context)  // 走 WorkManager,幂等
        }
    }
}

针对 SDK 初始化顺序:

我们做了一件事:把第三方 SDK 的初始化全部集中到一个文件里,并加注释说明依赖顺序。

/**
 * SDK 初始化顺序约定(改动前必须读)
 *
 * 1. ChannelInitializer  —— 必须最先,它写入的渠道信息被其他 SDK 读取
 * 2. PrivacyGate         —— 用户同意隐私政策后才可初始化任何采集类 SDK
 * 3. 其余业务 SDK         —— 依赖 1、2
 *
 * 严禁在 Application.onCreate 中直接初始化 SDK。
 * 2026-03 因小米/华为/OPPO/vivo 新 ROM 调整 Provider 加载顺序,
 * 导致 ChannelInitializer 被后置,出现空指针崩溃。
 */

**这个文件的价值不是代码,是"考古信息"。**半年后有人问"为什么这里要这么排",注释里有答案。否则就只能靠二分法注释去复现那个崩溃。

经验分享

给每个"看起来 inexplicable 的行为"留一个记录。

我们现在的项目里有一个 KNOWN_ISSUES.md,每条记录三件事:现象、根因、验证方式。举几条:

## 小米 MIUI 14+:自启动管理跳转必须用 startActivityForResult
- 现象:用 ActivityResultLauncher 跳转后拿不到授权结果
- 根因:MIUI 的权限页在跳转后不通过标准 Result 回调返回
- 验证:adb shell am start -n com.miui.securitycenter/...

## 华为 EMUI 11+:后台 Service 创建 Overlay 会被杀且无日志
- 现象:悬浮窗在 App 切后台 5 秒内消失,logcat 无任何输出
- 根因:Overlay 需要绑定前台 Activity Token
- 验证:在 addView 前后打印 Activity 可见性状态

这个文件救过我们很多次。**每次线上出问题,第一件事是查这个文档有没有类似记录。**有记录就 10 分钟定位,没记录就从头查。


坑 8:折叠屏、高刷与 Android 16 的行为变化

这个坑是"新特性"带来的,属于必须跟但踩不踩得到全看运气。

折叠屏:展开瞬间的崩溃

我们在 Mate X 系列上测到过:

IndexOutOfBoundsException at ...ViewGroup.measureVertical

触发时机非常刁钻:展开/折叠的瞬间。

原因是折叠屏展开时,DPI 和屏幕尺寸会在一次布局过程中发生变化。如果你的布局代码在 onMeasure 里缓存了上一次的尺寸,或者用了固定像素值,就会在这次"尺寸突变"里算错。

还有 60Hz → 120Hz 切换的问题:如果你在动画里用固定帧率算时间而不是用真实时间戳,在高刷屏上会看到明显撕裂。

我们的处理:

  1. 所有布局用 dp/sp,禁止在代码里硬编码 px。
  2. 用 WindowMetricsCalculator 或 WindowInsets 拿当前尺寸,每次都重新读,不缓存。
  3. 动画用 System.nanoTime() 的时间差,而不是"每帧 16ms"这种假设。
  4. 折叠屏形态变化用 onConfigurationChanged / WindowLayoutInfo 监听,不要用 screenWidth / 2 这种猜测。

Android 16(API 36):不是版本号的事,是行为的事

Google Play 的时间线:2026 年 8 月 31 日起,新 App 和更新必须 target API 36;存量 App 也有 11 月的窗口。

但真正要注意的不是能不能提交,是提上去之后行为变了。

**Edge-to-edge 强制默认,且没有退出开关。**target 到 API 36 之后,系统栏不再自动 inset。你的布局如果靠固定 margin/padding 避开状态栏和导航栏,会直接视觉错乱。这需要显式处理 WindowInsets。

**Predictive back 强制。**还在用 onBackPressed() 的代码会动画错乱甚至导航流程出错,必须迁到 OnBackPressedDispatcher。

**前台服务规则继续收紧。**Android 15 起 dataSync 类型前台服务有运行时长限制;Android 16 起,从前台服务启动的后台作业要遵守各自的运行时配额(包括 WorkManager 和 DownloadManager 创建的作业)。如果你在 Android 16 设备上发现 WorkManager 不跑了,先查这里。

**还有一个隐蔽的变化:target 到 API 35 之后,SYSTEM_ALERT_WINDOW 应用从后台启动前台服务的豁免被收窄了。**之前这类应用的豁免范围更广,现在必须当前有可见叠加窗口才能从后台拉起前台服务。这直接影响到坑 3 里的悬浮窗方案 —— 如果你的悬浮窗服务是"从后台被唤起"的,target 一升就会挂。

我们的处理过程

先说一句:不要把 targetSdk 当成合规打勾。

我们 2026 年的做法是:

  1. 提前一个季度做 retarget,不要卡在 8 月 31 日。
  2. 分批灰度(Play Console 百分比发布),让 targetSdk 36 的版本和旧版本同时在线,这样崩溃率和 ANR 率能直接对比。
  3. 崩溃和 ANR 数据按 targetSdk 版本切维度,而不是只看 OS 版本。不这么做的话,SDK 一升级,线上出问题你根本归因不到它头上。
  4. 设一个 delta 告警:targetSdk 36 的崩溃率比旧版本高出阈值,自动告警。

第 3 条是重点。很多团队把 crash rate 按 Android 版本分组,SDK 一升级,线上出问题你根本归因不到它头上。

关于依赖链的坑:targetSdk 提到 36 不是改一行 Gradle 的事。你得同时升级 AGP、Kotlin、AndroidX 库,以及所有第三方 SDK。第三方 SDK 那一环最耗时,而且你改不了自己的代码来绕过。一个一年没升级依赖的项目,会连着撞四五堵墙。


背后思考:我们为什么老在"撞坑"而不是"防坑"

写到这儿,我想说说方法论层面的东西,这可能比具体某个坑更有价值。

兼容性不是"测出来的",是"设计出来的"

老同事那句话我一直记着:"这种兼容性不是靠'检查'出来的,而是靠'撞'出来的。"

我们花了很多年才接受这个事实:**你不可能穷举所有机型 × 所有系统版本 × 所有厂商策略的组合。**这个组合是天文数字。

那怎么办?我们的答案是三条:

第一,用数据反推优先级,别做漫无目的的全量回归。

我们从崩溃平台拉一张表:按机型分组,算"崩溃率 ÷ 该机型市场占比"。

某机型崩溃率是它份额占比的 8 倍 → 立即提到 P0 审计级别

这个比"覆盖 200 台机器跑一遍"有效得多,而且能把有限的人力放在刀刃上。

第二,维护一张可信的真机矩阵,而不是"多买几台手机"。

我们现在的矩阵是这样选型的:

档位机型覆盖目标
P0小米 14(澎湃 OS 最新)份额最大的用户群 + 最新系统策略
P0华为 Mate 60(HarmonyOS 4.x)华为的 Android 兼容层
P0华为 Mate 60 Pro(HarmonyOS NEXT)原生鸿蒙,独立目标平台
P0OPPO Find X7(ColorOS 15)智能冻结策略
P1vivo X100(Funtouch 15)后台高耗电 + startForegroundService 拦截
P1荣耀 Magic6(MagicOS 9)荣耀独立策略
P1某低端机(Android 11,WebView 未更新)WebView 能力下限

注意第三行。华为的 HarmonyOS NEXT 和华为的 Android 兼容层,是两个完全不同的测试对象,我们为此单独准备了一台设备。

第三,把"低风险但数量大"的部分交给自动化。

UI 布局在不同 DPI 下会不会重叠、截断,这类问题用云真机跑一遍,成本低。我们把人力集中在 P0 机型的深度行为验证上。

但更重要的是:我们把"坑"变成了"资产"

这是我认为最值得分享的一点。

每次线上出问题,我们强制做三件事:

  1. 写进 KNOWN_ISSUES.md(现象 / 根因 / 验证方式)
  2. 写成一个可运行的检测脚本或单元测试
  3. 写进兼容矩阵的验证清单,下次发版自动跑

这三条的意义是:同一个坑,我们只踩一次。

举个真实的例子。前面说的"五家 ROM 同时崩在 Provider 初始化顺序"那个 bug,我们修完之后做了什么?

  • 写了一条单测:模拟"Application 初始化顺序错乱"场景,断言 ChannelInitializer 一定先于 AnalyticsTracker
  • 写了 KNOWN_ISSUES.md 的条目,注明了五个机型和厂商 ROM 版本
  • 在 CI 里加了一个检查:所有第三方 SDK 的初始化调用,必须出现在 PrivacyGate 或 SdkInitializer 指定的顺序里,用静态扫描实现,有新 SDK 插队直接构建失败

第三条是关键。如果只是"修好了",下一个人加 SDK 的时候还会踩。我们需要的是让它不能再被踩。

一个反直觉的结论

做完这些之后,我发现我们花在"具体兼容某个厂商"上的时间,其实变少了。

因为坑从"未知"变成了"已知",从"每次排查几小时"变成了"查文档 10 分钟"。

**兼容性的成本不在修复,在发现和记忆。**修复一个已知问题通常只要几十行代码,但发现它、定位它、记住它、防止它复发,这才是真正烧时间的地方。


沉淀下来的工程资产

最后把我们现在实际在用的东西列一下,这些是抄不了但可以照着做的:

1. 兼容矩阵文档(COMPATIBILITY.md)

不是机型参数表,是**"哪个行为在哪台机器上是什么表现"**的表:

能力小米 14 / 澎湃华为 / HarmonyOS 4OPPO / ColorOS 15vivo / Funtouch 15
后台 Service需自启动+关联启动+电池白名单需"应用启动管理"三开关"智能冻结"会杀前台服务startForegroundService 被拦
厂商推送MiPush token 正常HMS token 需 agconnect 配置OPPO Push 需 AppKeyvivo Push 需 api_key
悬浮窗需三开关齐需绑前台 Activity Token通用 Intent 被拦需手动引导
隐式广播部分拦截收紧收紧收紧
WebViewChromium 跟随商店更新华为自研内核ChromiumChromium

2. ROM 适配层(RomAdapter)

统一封装厂商差异,业务代码不出现任何 if (isXiaomi):

interface RomAdapter {
    fun getRomType(): RomType
    fun isAutoStartEnabled(): Boolean
    fun openAutoStartSettings(activity: Activity)
    fun isIgnoringBatteryOptimizations(context: Context): Boolean
    fun openBatteryOptimizationSettings(activity: Activity)
    fun isOverlayFullyGranted(context: Context): Boolean
    fun openOverlaySettings(activity: Activity)
}

关键设计原则:厂商判断集中在 RomDetector 一个文件里,厂商跳转集中在各家的 Adapter 里,业务层零感知。

3. 发版前自检脚本(SelfCheckRunner)

在 App 启动后跑一遍,结果上报到自己的监控:

[SelfCheck] rom=MIUI_HyperOS
[SelfCheck] autostart=GRANTED
[SelfCheck] batteryOpt=IGNORED
[SelfCheck] notification=GRANTED
[SelfCheck] overlay=NOT_REQUIRED
[SelfCheck] pushToken=huawei(HMS):OK mi(Xiaomi):OK oppo:OK vivo:OK

**这份报告在用户投诉"收不到消息"的时候,能省掉 80% 的排查时间。**用户截图发过来,我们一看就知道是哪个开关没开。

4. 兼容测试清单(COMPAT_CHECKLIST.md)

每个版本发版前必跑,每一项都有明确的通过标准:

- [ ] ROM 识别正确(5 台 P0 机型,输出与预期一致)
- [ ] 自启动/关联启动引导(未授权时能跳到正确页面)
- [ ] 后台存活(息屏 30 分钟后本地数据时间戳有更新)
- [ ] 厂商推送(杀进程后消息仍能送达,5 家各测 3 条)
- [ ] 悬浮窗(授权后切后台 10 秒仍存在)
- [ ] 隐私合规(未同意前无任何网络请求,用 Charles 抓包验证)
- [ ] WebView(Chromium 74 环境全流程跑通)
- [ ] Android 16 edge-to-edge(各页面无遮挡)
- [ ] 折叠屏展开/折叠无崩溃

5. 崩溃归因规则

Crashlytics 里按 ROM 类型 + targetSdk 版本 做自定义维度,而不是按机型名。

// 上报时带上这两个维度
crash.setCustomKey("rom_type", RomDetector.getRomType().name)
crash.setCustomKey("target_sdk", BuildConfig.TARGET_SDK.toString())

这样你才能问出"是小米的问题还是我的问题"这种问题。


最后

回顾这八个坑,它们看起来五花八门,但底下是同一条逻辑:

**国产 Android 的每一个坑,背后都是厂商的一个明确的产品决策或商业目标。**省电、续航、跑分、应用商店生态、隐私合规门槛——这些目标决定了系统会怎么对待你的进程、你的权限、你的推送。

你没法说服系统。你只能:

  1. 知道它在防什么,这样你才能预测它什么时候会动手
  2. 走官方通道申请许可,而不是跟系统对抗
  3. 把"被杀也能活"设计进架构,而不是赌进程一直活着
  4. 把每一个坑变成一个可执行的检测,让它从"事故"变成"状态"

**第四点是最容易被跳过、但价值最高的一点。**修 bug 只解决当下,把 bug 变成检测和流程,才解决明年。

如果你也在做国产 Android 的适配,欢迎在评论区聊聊你遇到过的更离谱的坑。我个人最想看看的,是那些官方文档里查不到、只能靠撞出来的问题——比如某个厂商的某个 ROM 版本,因为一次推送,把你的某个系统 API 行为改了,但文档一个字都没提。

那种坑,才是真正的"撞出来的"。


文中涉及的具体菜单路径、Intent 和厂商私有 API 会随 ROM 版本变化,落地时请以目标机型的实际版本为准。我们团队的做法是:所有厂商相关代码集中在一个目录,升级 ROM 时只动那一个目录。