起因:一个查不出原因的空指针
去年 11 月,我们收到运营转来的投诉:"健康南京 App 在部分安卓手机上打开就闪退。"
第一反应是版本问题。查崩溃日志,Bugly 上写着:
csharp
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 的不是一个东西,是三层叠加。**很多团队只处理第一层,然后被第二三层反复打脸。
arduino
第 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 拦截 | 不定,随机 | 无 |
| 原生 Android | Doze / App Standby 桶降级 | 小时级 | 有 |
为什么厂商要这么做
这是所有兼容文章里最少讲、但最重要的一段。
厂商的出发点不是"针对你的 App",是整机续航和跑分。手机厂商卖的是硬件,用户拿同款 OPPO 和别家对比续航,差 5% 就影响销量。为了这个目标,系统层必须做两件事:
- 尽可能多地冻结后台进程,省内存、省 CPU、省电。
- 让"用户主动允许"成为唯一的后台存活路径------因为用户点了"允许",出问题用户不会来找厂商投诉,厂商也没有理由再激进。
所以你会看到一个反直觉的现象:**厂商的策略越激进,官方文档越含糊。**因为它本质上是"防你(开发者)偷电",而不是一项对外承诺的特性。你去翻小米的开发者文档,是找不到"自启动管理会杀你的 App"这条的。
理解到这一层,很多"bug"就变成了"预期行为"。你不能去说服系统,你只能去申请权限,或者绕开它。
我们的处理过程
第一步是建立 ROM 识别层 。我们写了 RomDetector,不靠 Build.MANUFACTURER(这个在荣耀上返回的是 "HONOR" 还是 "HUAWEI"?在小米海外版上又是什么?),而是靠系统属性:
kotlin
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()的组合。
第三步是别把保活当唯一解 。我们最终的方案是:放弃"进程永远活着"这个执念,改成"进程死了也能恢复"。
具体做法是三件事:
- 所有状态持久化到本地,进程被杀不丢数据(这个本来就是必须的,很多团队却栽在这)。
- 所有关键操作用幂等设计,重复执行不会产生脏数据。
- 用
WorkManager+AlarmManager兜底 ,而不是自己写while(true)循环 +startService拉活。
第三点我们要特别强调一个反直觉的经验:**很多网上的"保活方案"(Cactus、双进程守护、JobScheduler 无限循环)本质是在跟系统对抗,对抗的代价是功耗、耗电、ANR 率、审核风险。**我们实测过,一台小米手机上跑双进程守护,24 小时额外耗电 11%--14%,而且在系统更新后随时可能失效。
真正靠谱的保活只有一条:把需要后台执行的活,交给系统认可的执行器(厂商通道推送、WorkManager、AlarmManager),然后把用户引导做到位。
经验分享
后台保活这件事,我们的认知经历了三个阶段:
阶段一 :以为有通用方案 → 搜了一堆开源库 → 每家都失效。 阶段二 :以为靠引导用户设置就能解决 → 发现引导页的转化率只有 3%--7%,而且用户随时会被系统重置回去。 阶段三:接受"会被杀"是常态,把架构改成"被杀也能活"。
现在我们上线一个需要后台能力的功能(比如健康数据定时同步、用药提醒),流程固定是三步:
- 能不能用推送唤起? → 能,就别保活,用厂商通道推。
- 不能推,但可以用系统调度器? → 用 WorkManager +
setRequiredDelay,配合AlarmManager.setExactAndAllowWhileIdle做兜底。 - 都不行(必须常驻,比如蓝牙采集)? → 这时候才做前台服务 + 引导用户加白名单。
**顺序不能反。**我们见过太多团队一上来就搞双进程守护,其实业务上根本用不着。
还有一个容易忽略的:**引导用户加白名单之后,必须验证它真的生效了。**用户在小米的"电池"里选了"无限制",不代表"自启动管理"里的开关也开了。这两个是独立的开关。华为的"应用启动管理"更是三个独立开关。
我们的自检脚本是这样的逻辑:加完白名单后,让 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 有"通知智能管理/免打扰",会在锁屏后自动折叠通知甚至延迟投递。**用户去设置里看一眼就全明白了,但这需要在引导文案里说清楚。
我们最终的推送架构
markdown
┌─────────────────────────────────────────────┐
│ 消息分级(不是所有消息都走推送) │
│ 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:悬浮窗 / 后台弹窗权限------三重门校验
这个坑的隐蔽程度排第二,但排查难度排第一。
现象
rust
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,是小米在明确表达一个产品决策:你不该在用户已经"关掉"你的情况下继续弹窗。
我们的处理过程
我们放弃了"一次检测 + 一次跳转"的思路,改成三阶检测法:
kotlin
// 阶 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 definedSyntaxError: 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 内核可能差好几个大版本 ",而同一台机器,隔一个月行为就可能不一样。
我们的处理过程
第一步:不猜,做运行时能力检测。
启动时执行一次探测脚本,把结果存到本地:
javascript
(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 格式,我们就漏判了。
第二步:降级路径要写死在代码里。
javascript
// 不依赖 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/ 下的日志,能看到渲染进程被杀。
我们的处理是两条:
- 全部资源走 HTTPS,减少明文流量被中断的概率。
- 给 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) 里,只有用户同意后才调用。
kotlin
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 个。你需要:
- 把所有 build 配置和依赖文件翻一遍
- 跑
./gradlew :app:dependencies拿到完整的依赖树 - 逐个查每个 SDK 的隐私说明文档,确认它收集什么数据
- 和隐私政策逐条对照
我们把这个过程做成了 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"这个方案,改成了三重触发:
BOOT_COMPLETED(可能失效,作为兜底之一)- 应用启动时检查本地数据的最后同步时间,超过阈值就补一次(最可靠)
- 厂商通道推送下发一个"该同步了"的自定义消息(最及时,且不受进程存活影响)
第 2 条是关键。不要依赖"系统会叫我",要依赖"我启动时先看看有没有欠账"。
我们把这个模式抽成了一个通用的 SyncScheduler:
kotlin
object SyncScheduler {
fun onAppStart() {
val last = PreferenceStore.lastSyncTime
if (System.currentTimeMillis() - last > SYNC_INTERVAL) {
SyncWorker.enqueue(context) // 走 WorkManager,幂等
}
}
}
针对 SDK 初始化顺序:
我们做了一件事:把第三方 SDK 的初始化全部集中到一个文件里,并加注释说明依赖顺序。
kotlin
/**
* 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,每条记录三件事:现象、根因、验证方式。举几条:
markdown
## 小米 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 切换的问题:如果你在动画里用固定帧率算时间而不是用真实时间戳,在高刷屏上会看到明显撕裂。
我们的处理:
- 所有布局用
dp/sp,禁止在代码里硬编码 px。 - 用
WindowMetricsCalculator或WindowInsets拿当前尺寸,每次都重新读,不缓存。 - 动画用
System.nanoTime()的时间差,而不是"每帧 16ms"这种假设。 - 折叠屏形态变化用
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 年的做法是:
- 提前一个季度做 retarget,不要卡在 8 月 31 日。
- 分批灰度 (Play Console 百分比发布),让 targetSdk 36 的版本和旧版本同时在线,这样崩溃率和 ANR 率能直接对比。
- 崩溃和 ANR 数据按 targetSdk 版本切维度,而不是只看 OS 版本。不这么做的话,SDK 一升级,线上出问题你根本归因不到它头上。
- 设一个 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) | 原生鸿蒙,独立目标平台 |
| P0 | OPPO Find X7(ColorOS 15) | 智能冻结策略 |
| P1 | vivo X100(Funtouch 15) | 后台高耗电 + startForegroundService 拦截 |
| P1 | 荣耀 Magic6(MagicOS 9) | 荣耀独立策略 |
| P1 | 某低端机(Android 11,WebView 未更新) | WebView 能力下限 |
注意第三行。华为的 HarmonyOS NEXT 和华为的 Android 兼容层,是两个完全不同的测试对象,我们为此单独准备了一台设备。
第三,把"低风险但数量大"的部分交给自动化。
UI 布局在不同 DPI 下会不会重叠、截断,这类问题用云真机跑一遍,成本低。我们把人力集中在 P0 机型的深度行为验证上。
但更重要的是:我们把"坑"变成了"资产"
这是我认为最值得分享的一点。
每次线上出问题,我们强制做三件事:
- 写进
KNOWN_ISSUES.md(现象 / 根因 / 验证方式) - 写成一个可运行的检测脚本或单元测试
- 写进兼容矩阵的验证清单,下次发版自动跑
这三条的意义是:同一个坑,我们只踩一次。
举个真实的例子。前面说的"五家 ROM 同时崩在 Provider 初始化顺序"那个 bug,我们修完之后做了什么?
- 写了一条单测:模拟"Application 初始化顺序错乱"场景,断言 ChannelInitializer 一定先于 AnalyticsTracker
- 写了
KNOWN_ISSUES.md的条目,注明了五个机型和厂商 ROM 版本 - 在 CI 里加了一个检查:所有第三方 SDK 的初始化调用,必须出现在
PrivacyGate或SdkInitializer指定的顺序里,用静态扫描实现,有新 SDK 插队直接构建失败
第三条是关键。如果只是"修好了",下一个人加 SDK 的时候还会踩。我们需要的是让它不能再被踩。
一个反直觉的结论
做完这些之后,我发现我们花在"具体兼容某个厂商"上的时间,其实变少了。
因为坑从"未知"变成了"已知",从"每次排查几小时"变成了"查文档 10 分钟"。
**兼容性的成本不在修复,在发现和记忆。**修复一个已知问题通常只要几十行代码,但发现它、定位它、记住它、防止它复发,这才是真正烧时间的地方。
沉淀下来的工程资产
最后把我们现在实际在用的东西列一下,这些是抄不了但可以照着做的:
1. 兼容矩阵文档(COMPATIBILITY.md)
不是机型参数表,是**"哪个行为在哪台机器上是什么表现"**的表:
| 能力 | 小米 14 / 澎湃 | 华为 / HarmonyOS 4 | OPPO / ColorOS 15 | vivo / Funtouch 15 |
|---|---|---|---|---|
| 后台 Service | 需自启动+关联启动+电池白名单 | 需"应用启动管理"三开关 | "智能冻结"会杀前台服务 | startForegroundService 被拦 |
| 厂商推送 | MiPush token 正常 | HMS token 需 agconnect 配置 | OPPO Push 需 AppKey | vivo Push 需 api_key |
| 悬浮窗 | 需三开关齐 | 需绑前台 Activity Token | 通用 Intent 被拦 | 需手动引导 |
| 隐式广播 | 部分拦截 | 收紧 | 收紧 | 收紧 |
| WebView | Chromium 跟随商店更新 | 华为自研内核 | Chromium | Chromium |
2. ROM 适配层(RomAdapter)
统一封装厂商差异,业务代码不出现任何 if (isXiaomi):
kotlin
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 启动后跑一遍,结果上报到自己的监控:
ini
[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)
每个版本发版前必跑,每一项都有明确的通过标准:
markdown
- [ ] ROM 识别正确(5 台 P0 机型,输出与预期一致)
- [ ] 自启动/关联启动引导(未授权时能跳到正确页面)
- [ ] 后台存活(息屏 30 分钟后本地数据时间戳有更新)
- [ ] 厂商推送(杀进程后消息仍能送达,5 家各测 3 条)
- [ ] 悬浮窗(授权后切后台 10 秒仍存在)
- [ ] 隐私合规(未同意前无任何网络请求,用 Charles 抓包验证)
- [ ] WebView(Chromium 74 环境全流程跑通)
- [ ] Android 16 edge-to-edge(各页面无遮挡)
- [ ] 折叠屏展开/折叠无崩溃
5. 崩溃归因规则
Crashlytics 里按 ROM 类型 + targetSdk 版本 做自定义维度,而不是按机型名。
kotlin
// 上报时带上这两个维度
crash.setCustomKey("rom_type", RomDetector.getRomType().name)
crash.setCustomKey("target_sdk", BuildConfig.TARGET_SDK.toString())
这样你才能问出"是小米的问题还是我的问题"这种问题。
最后
回顾这八个坑,它们看起来五花八门,但底下是同一条逻辑:
**国产 Android 的每一个坑,背后都是厂商的一个明确的产品决策或商业目标。**省电、续航、跑分、应用商店生态、隐私合规门槛------这些目标决定了系统会怎么对待你的进程、你的权限、你的推送。
你没法说服系统。你只能:
- 知道它在防什么,这样你才能预测它什么时候会动手
- 走官方通道申请许可,而不是跟系统对抗
- 把"被杀也能活"设计进架构,而不是赌进程一直活着
- 把每一个坑变成一个可执行的检测,让它从"事故"变成"状态"
**第四点是最容易被跳过、但价值最高的一点。**修 bug 只解决当下,把 bug 变成检测和流程,才解决明年。
如果你也在做国产 Android 的适配,欢迎在评论区聊聊你遇到过的更离谱的坑。我个人最想看看的,是那些官方文档里查不到、只能靠撞出来的问题------比如某个厂商的某个 ROM 版本,因为一次推送,把你的某个系统 API 行为改了,但文档一个字都没提。
那种坑,才是真正的"撞出来的"。
文中涉及的具体菜单路径、Intent 和厂商私有 API 会随 ROM 版本变化,落地时请以目标机型的实际版本为准。我们团队的做法是:所有厂商相关代码集中在一个目录,升级 ROM 时只动那一个目录。