Flutter中UUID与Shared Preferences存储异常排查求助（特定设备）

一、SharedPreferences 存储相关排查 #

• 引导客户检查设备存储状态：
  • 确认设备内部存储是否已满，SharedPreferences需要足够剩余空间完成数据写入
  • 检查应用是否被设置了「禁止写入存储」权限——虽然官方文档标注无需权限，但Motorola的定制ROM可能存在特殊权限管控逻辑
• 建议客户清除应用缓存和数据后重试：
  • 操作路径：设置 > 应用 > 你的应用 > 存储 > 清除缓存/清除数据
  • 清除完成后重启应用，验证UUID是否能正常生成并存储

二、UUID生成与初始化流程排查 #

• 引导客户确认异常触发时机：
  • 询问灰屏是启动立即出现，还是进入游客登录流程后才出现
  • 确认设备是否弹出过应用无响应、存储失败之类的后台提示
• 基于现有代码自查逻辑：
  • 检查是否在UI线程直接执行SharedPreferences读写操作——该设备搭载Android 11+系统，对UI线程IO操作限制更严格，可能引发ANR导致灰屏
  • 确认UUID生成后的非空判断：即使Uuid().v4()返回null概率极低，也要确保生成后先做非空校验再执行存储
  • 检查SharedPreferences初始化时机：必须等待SharedPreferences.getInstance()的Future完成后再执行读写，避免未初始化完成就操作导致失败

三、设备系统与定制ROM相关排查 #

• 询问客户设备的具体系统版本：该机型出厂为Android 11，部分用户可能升级到Android 12/13，不同版本的存储机制存在差异
• 检查设备隐私保护设置：
  • Motorola定制ROM的隐私模式可能限制应用访问存储或生成唯一标识，引导客户关闭应用的隐私隔离，或将应用加入信任列表
• 确认设备是否ROOT或刷入自定义ROM：ROOT后的设备可能修改了存储权限规则，导致SharedPreferences无法正常写入

四、无调试APK情况下的信息收集 #

• 引导客户导出系统日志：
  • 让客户在灰屏出现后，进入设置 > 系统 > 开发者选项 > 日志记录器导出日志（未开启开发者选项可先进入「关于手机」连续点击版本号激活）
  • 让客户提取日志中包含SharedPreferences、UUID、ANR、IOException的报错信息发送
• 询问是否有同型号其他设备出现相同问题：判断是单设备异常还是该型号普遍问题

内容的提问来源于stack exchange，提问作者cscommunity dev