Flutter应用发布更新后手机端运行异常，SQLite保存数据不显示问题

最常见原因：R8/ProGuard代码混淆导致映射失效 #

你在模拟器运行的是debug包，默认关闭代码混淆，发布到Google Play的release包默认开启R8压缩混淆：

• 如果你使用sqflite配合ORM框架（Floor、Drift等），或是自行通过字段名反射做数据映射，混淆后实体类字段会被重命名为无意义的单字符，导致数据写入正常但读取时无法映射字段，最终查询结果为空
• 保存成功提示仅代表SQL执行无异常，和后续查询、映射逻辑无关

修复方案： #

• 给所有数据库实体类添加@Keep注解，或在安卓项目app/proguard-rules.pro中添加实体类包保留规则：

# 保留数据库实体类不被混淆
-keep class 你的实体类全量包名.** { *; }

• 如果你使用第三方ORM框架，添加框架官方提供的混淆规则即可，例如Floor的规则：

-keep class * extends androidx.room.RoomDatabase
-keep @androidx.room.Entity class * { *; }

• 打包release版本后检查app/build/outputs/mapping/release/mapping.txt文件，确认实体类、数据库操作类没有被重命名。

次常见原因：API升级导致数据库存储路径变更 #

从API16升级到API19后，安卓内部存储的默认访问路径规则有调整：

• 如果你之前硬编码了数据库存储路径，没有使用官方推荐的路径获取接口，会出现新写入的数据存在新路径，查询时读取旧路径数据库的情况，导致看不到新写入的数据

修复方案： #

• 统一使用sqflite官方提供的getDatabasesPath()方法拼接数据库路径，不要硬编码路径：

import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';

final dbPath = join(await getDatabasesPath(), 'your_database_name.db');
final database = await openDatabase(dbPath);

• 如需兼容旧用户数据，可新增路径迁移逻辑，将旧路径下的数据库文件移动到新的标准路径。

其他排查方向 #

本次更新同步新增了功能，也可能是新增逻辑导致的问题：

• 检查列表查询是否新增了筛选条件，release编译优化导致判断逻辑不符合预期，过滤了新写入的数据
• 本地打包release版本安装到真机复现，通过Android Studio Logcat打印SQL查询语句和返回结果，确认问题出在查询层还是前端渲染层

内容的提问来源于stack exchange，提问作者Zon Ch