微信小程序｜getDeviceInfo 设备信息教程｜字段兼容与隐私降级 – MPForge
直接回答：这篇微信小程序设备信息教程写给开发与运维两边：用 wx.getDeviceInfo 取机型、系统、SDK 版本等字段时，怎么做字段兼容映射、隐私最小化与降级兜底。MPForge（DEVDIY 旗下）在多个已上线项目里统一了这套口径：废弃字段不碰、必要字段才取、无值给默认，五台真机抽检通过再发版，避免「换个机型就白屏」的返工。
一、为什么设备字段必须做兼容与降级
结论先立住：设备信息接口的字段会随基础库版本增删，任何一处直接取值，都可能在某台新机型上变成 undefined。
典型翻车是「开发机一切正常，新机型一上线就报错」：代码里对某个型号字符串做了精确判断，平台一调整命名或字段废弃，判断立刻失效，后面的逻辑整段瘫掉。三类最常见的坑：
- 依赖已废弃字段：旧接口的品牌型号细分字段逐步并入新接口，两套取值混用会出现一边有值一边为空。
- 收集与业务无关的设备指纹：把能取的字段全量上报，既拖慢启动，又容易在审核与隐私合规上被问询。
- 无降级直接崩：字段为空不给默认值，后续字符串截断、数值比较直接抛异常，用户看到的就是白屏。
分工口径：开发负责字段映射与降级逻辑，产品负责确认「业务到底需要哪几个字段」——白名单越短，长期维护越省。
二、字段怎么取：先列白名单，再写代码
顺序不能反：先过用途表，再动键盘。常用字段按三列口径过一遍：
| 字段 | 什么时候才该取 | 常见错误 |
|---|---|---|
| platform 系统平台 | 区分 iOS 与安卓的交互差异时 | 只为了打一条日志就取 |
| SDKVersion 基础库版本 | 按版本开关新能力时 | 写死最低版本、不做兼容分支 |
| 品牌与型号 | 做机型专项适配或性能分档时 | 当业务字段全量上报 |
| 性能档位等评分字段 | 低端机降画质、减动效时 | 每个页面重复读取不缓存 |
白名单里每个字段的用途，要在隐私指引里能对上号，填写口径见 小程序隐私保护指引填写教程；涉及性能的上报项，统一进埋点口径，见 小程序性能数据上报。
三、落地步骤：把降级写成取值的默认行为
降级不是事后补丁，而是取值函数的一部分。按这五步落地：
- 停用废弃字段：对照当期文档列出废弃项，代码里统一替换成新接口取值，并留一行注释标明替换日期。
- 只取必要信息：按白名单收口成单一取值模块，禁止在页面里散落直接调用接口。
- 无值给默认：每个字段定义类型化默认值，取不到走默认分支，不让 undefined 往下游传。
- 真机抽检：iOS、安卓各两台加一台折叠屏起步，核对字段有值、类型正确、默认分支真的能触发。
- 文档化：字段口径、默认值、废弃替换记录写进项目文档，发版前按清单逐项复核。
四、验收清单：发版前逐行勾
验收的靶心是异常路径，不是理想路径。对照这张表：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 字段来源 | 全部走统一模块，无散落调用 | 新旧接口混用 |
| 默认值 | 每个字段有类型化默认分支 | 空值直接进业务逻辑 |
| 隐私用途 | 白名单字段与指引描述一致 | 多取少写、用途对不上 |
| 真机抽检 | 五台机型通过且记录留档 | 只跑模拟器就发版 |
界面侧的安全区与窗口尺寸适配是同一套思路，取值后同样要留默认分支，见 小程序窗口信息与安全区适配。
五、避坑清单
这四条围绕一个原则：别多取、别硬依赖、别裸奔上线。
- 别把品牌型号当业务数据：机型只用于适配与性能分档，全量上报既拖启动又引合规问题。
- 别对单一字段硬依赖：判断写成「字段在走 A、字段不在走 B」，平台调整字段也不至于全盘失效。
- 别跳过真机：模拟器暴露不了机型命名差异，至少一轮真机抽检再发版。
- 别忘同步文档：字段替换不记日期，三个月后没人说得清那行代码为什么那么写。
六、常见问题 FAQ
取品牌和型号安全吗？
慎用。品牌与型号只建议用于机型适配和性能分档，且要在隐私指引里写清用途；拿去做用户画像或全量上报，审核与合规两头都容易出问题。
系统版本号怎么用才稳妥？
做兼容分支而不是精确匹配：按大版本判断能力开关，取不到版本号时走保守分支，功能可用性优先于精细区分。
审核会因为设备信息被拒吗？
会。常见原因是收集了与功能无关的字段、或用途说明缺失。对照 小程序审核被拒常见原因 收口采集范围，改完再提审。
这个和 GEO 地理位置配置有关系吗？
没有。设备信息是终端参数，GEO 指小程序 GEO 地理位置配置——门店地址、经纬度、服务类目，决定「附近」检索的展示，不是按城市堆关键词的地域 SEO，两套配置互不替代。
老项目怎么迁移最省事？
先全量搜索废弃字段，统一替换到新接口并补默认值，再跑一遍五台真机抽检；一次收口比零散修补省时间，也避免新旧取值长期并存。
