Flutter应用Google Console发布版异常：新安装不显示引导页

核心现象 #

• 本地Debug/直接运行Release包：功能正常，引导页展示、API调用均符合预期
• Google Play Console发布的App Bundle安装包：新安装时跳过引导页直接跳转登录页，API调用异常；仅手动清除应用数据+缓存后恢复正常

可能原因与排查方向 #

1. App Bundle代码混淆/资源压缩逻辑异常 #

虽然你调整过minifyEnabled和shrinkResources，但仍需确认：

• 检查proguard-rules.pro（Android端）或Flutter混淆配置，是否误移除了引导页、本地存储（如SharedPreferences、Hive）相关的类/方法
• 验证是否因R8压缩导致首次启动的本地存储初始化逻辑被优化丢弃——比如引导页依赖的isFirstLaunch标记，其初始化代码被混淆删除，导致默认值判断错误直接跳登录
• 测试：用bundletool将App Bundle生成通用APK，安装到设备复现问题，排除Google Play分发环节的特殊影响

2. Google Play App Signing配置冲突 #

• 确认App Bundle的签名是否与本地测试Release包一致：Google Play会替换上传的签名，若你的应用依赖签名做本地校验（比如API请求的签名验证），会直接导致API调用失败，进而触发异常跳转
• 排查API请求错误日志：如果API因签名不一致返回错误，应用可能直接触发登录页跳转逻辑，而非引导页

3. 首次启动本地存储逻辑漏洞 #

引导页的展示通常依赖本地存储标记（如SharedPreferences中的hasSeenWalkthrough），需排查：

• 检查SplashScreen的initState中，是否在首次启动时正确初始化该标记？是否因异步逻辑顺序问题，提前读取了未初始化的标记（默认值为true，直接跳登录）
• 确认是否存在跨进程/多线程的本地存储读写冲突：Google Play分发的包可能因进程优先级差异，导致首次启动时读取到异常缓存值（即使是新安装，也可能存在Play Store的残留缓存）
• 临时测试：在首次启动时强制清除本地存储的相关标记，再执行引导页判断逻辑，观察是否解决问题

4. Google Play安装缓存残留 #

• 完全卸载应用后，清除Play Store的缓存，再重新安装测试，排除旧安装缓存的影响
• 通过Google Play内部测试渠道发布包，验证问题是否依然存在

5. Flutter Release模式打包差异 #

本地直接运行Release和App Bundle打包的Release可能存在优化差异：

• 检查执行flutter build appbundle时是否添加了额外编译参数（如--no-tree-shake-icons等），导致逻辑出现差异
• 对比本地Release包和App Bundle生成的APK的关键逻辑，用反编译工具确认引导页判断、API调用代码是否一致

下一步建议 #

• 补充SplashScreen中引导页判断的核心代码、本地存储初始化逻辑
• 收集Google Play安装包的首次启动日志（用Firebase Crashlytics或Logcat），查看是否有初始化失败、API请求错误的具体信息
• 用bundletool生成APK后安装测试，确认问题出在App Bundle打包环节还是Google Play分发环节

内容的提问来源于stack exchange，提问作者Hadi Emile