uni-app如何实留在App端获取手机的唯一设备标识UUID-uni-app-PHP中文网

plus.device.uuid不可靠，应弃用；需采用oaid→android_id→本地uuid链式降级方案，ios须自生成v4 uuid并三重持久化，所有id必须服务端校验。

uni-app如何实留在app端获取手机的唯一设备标识uuid

plus.device.uuid 不可靠，别当主力用

直接调用 plus.device.uuid 返回的值在 Android 12+ 和部分厂商 ROM（如 vivo Funtouch OS、华为鸿蒙 3.0+）上会是空字符串或固定值；iOS 上它随 App 卸载重装而改变，且不跨 App 一致。这不是你调用时机不对，而是该 API 本身不具备设备级稳定性——它由 5+ Runtime 生成，不是系统级标识。

常见错误现象：plus.device.uuid 在真机冷启动时偶尔为 "" 或重复出现相同字符串（尤其多台同型号测试机）；H5 环境下该属性根本不存在，直接报 Cannot read property 'uuid' of undefined。

不要在 onLaunch 里依赖它做登录态绑定或设备风控
不要把它传给服务端当作“设备指纹”校验，容易批量误判
若项目仍需兼容老基座（如 HBuilderX 3.1.x），可读取但必须加空值 fallback

Android 10+ 必须走 OAID → android_id → 本地 UUID 链式降级

安卓生态里没有“一招鲜”的设备 ID，合规又可用的方案是按优先级逐层尝试，每层失败就往下走，不能卡死在某一个。

实操建议：

plus.device.getOAID 是首选：需确认打包为 App 平台、使用「自定义基座」并勾选「OAID 支持」；首次调用有 200–500ms 延迟，务必在 App.vue 的 onLaunch 中预热并缓存结果

fallback 到 android_id：用原生桥接方式获取，避免过时的 plus.device.androidId（部分基座已移除）。示例代码片段：

const context = plus.android.importClass('android.content.Context');<br>const settingsSecure = plus.android.importClass('android.provider.Settings$Secure');<br>const main = plus.android.runtimeMainActivity();<br>const resolver = main.getContentResolver();<br>const androidId = settingsSecure.getString(resolver, 'android_id') || '';

拼接 Build.SERIAL 提升区分度（需非空且不等于 "unknown"），再和 android_id 用下划线连接
所有环节都必须判断空值：if (!oaid || oaid === '00000000-0000-0000-0000-000000000000') 视为失败

iOS 上只能靠本地生成 + 持久化 UUID

iOS 没有 OAID，也没有稳定可用的 deviceToken（那是 APNs 推送专用）、identifierForVendor（卸载重装即变）、advertisingIdentifier（用户可关闭且需额外权限）。唯一可控路径是自己生成并落地存储。

uni-app

uni-app 官方文档、npm 包和项目创建入口。

下载

注意点：

别用 new Date().getTime() + Math.random() 拼接——熵太低，多设备并发启动可能撞车

推荐标准 v4 UUID 生成逻辑：

function generateUUID() {<br>  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {<br>    const r = Math.random() * 16 | 0;<br>    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);<br>  });<br>}

持久化要三重保险：uni.setStorageSync('device_id', id) + plus.storage.setItem('device_id', id) + 写入本地文件（防 iOS 17+ 对 uni.setStorageSync 沙盒写入偶发失败）
首次启动检测 uni.getStorageSync('device_id') 是否存在，不存在才生成并落盘