HarmonyOS 鸿蒙Next本地系统完整性检测

开发者您好，“系统完整性检测”为过时的文档，已不再维护，推荐您使用“本地系统完整性检测”。

问题1：

DevEco Studio 本地模拟器返回：

801 - API is not support

这个基本属于正常现象。

因为：

本地系统完整性检测很多能力依赖：

• 真机 TEE
• 安全芯片
• 可信执行环境
• 系统安全服务

而模拟器本身并不具备这些安全硬件能力。

所以：

并不是返回：

emulator

而是直接：

API not support

可以理解为：

“当前环境不支持完整性检测能力”。

目前很多安全类 API：

• 完整性检测
• 密钥认证
• 安全组件
• Device Attestation

模拟器都不支持。

⸻

问题2：

云调试设备返回：

attack
unlock

这个也不一定真的是“设备被攻击”。

云调试设备很多属于：

• 工程机
• 调试机
• 解锁设备
• 自动化测试设备

系统状态往往不是“消费者正式态”。

例如：

unlock

通常表示：

Bootloader / 系统状态非锁定。

而：

attack

很多时候是：

系统检测到：

• 调试环境
• Hook
• Root痕迹
• 非正式系统态
• 自动化框架

所以直接归类为风险环境。

云调试设备经常会出现这种情况。

不要把它等同于：

“真的被黑客攻击”。

⸻

问题3：

两个接口返回类型不同，

本质是：

它们不是同一套能力。

⸻

“系统完整性检测”

偏：

远程 / 云侧 / 基础完整性校验。

返回维度较少：

jailbreak
emulator
attack

⸻

“本地系统完整性检测”

偏：

设备本地安全服务。

能获取更多本地状态。

所以新增了：

unlock

这种更细粒度结果。

⸻

可以理解为：

本地检测：

更接近：

“设备实时安全状态”。

而旧版系统完整性检测：

更像：

“设备基础可信校验”。

⸻

所以从能力上来说：

确实：

本地系统完整性检测更细。

但并不代表：

“完全替代”。

而是：

两者定位不同。

⸻

一句话总结：

1、模拟器返回 801 基本正常，因为安全完整性能力依赖真机硬件；

2、云调试设备出现 attack/unlock 很常见，因为很多云设备本身就是调试态；

3、本地系统完整性检测比旧版系统完整性检测返回维度更细，属于更强的本地安全状态检测能力。