Flutter发布版APK中notifyListeners()失效致加载无法结束

1. 修复代码混淆问题 #

Flutter发布版默认启用R8混淆，可能破坏Provider的状态监听逻辑。在android/app/proguard-rules.pro中添加以下规则，保留状态管理相关类不被混淆：

# 保留ChangeNotifier子类的所有公共成员
-keep class * extends ChangeNotifier {
    public *;
}
# 若使用StateNotifier，补充对应规则
-keep class * extends StateNotifier {
    public *;
}

同时确保android/app/build.gradle的release配置引用该规则：

release {
    minifyEnabled true
    shrinkResources true
    proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}

2. 补全异步操作的错误捕获与状态更新 #

发布版中未捕获的异常会被静默处理，导致状态停留在加载中。修改Provider的API请求函数，确保所有分支都更新状态并调用notifyListeners()：

Future<void> getUserSites() async {
  try {
    isLoading = true;
    notifyListeners(); // 触发加载状态更新
    final response = await apiService.fetchUserSites();
    userSites = response.data;
    errorMessage = null;
  } catch (e) {
    errorMessage = e.toString();
    userSites = [];
  } finally {
    isLoading = false;
    notifyListeners(); // 无论成功失败，都更新状态
  }
}

3. 检查发布版网络配置 #

Android发布版默认禁止明文HTTP请求，若API使用HTTP协议，需配置网络安全策略：
在android/app/src/main/res/xml下创建network_security_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

然后在android/app/src/main/AndroidManifest.xml的<application>标签中添加：

android:networkSecurityConfig="@xml/network_security_config"

若使用自签名HTTPS证书，需额外添加证书信任配置，否则发布版会拒绝请求。

4. 验证Provider的页面监听方式 #

确保页面通过Consumer或Selector监听状态变化，而非直接读取状态：

// 正确示例：用Consumer自动监听状态更新
Consumer<SiteProvider>(
  builder: (context, provider, child) {
    if (provider.isLoading) {
      return CircularProgressIndicator();
    }
    if (provider.errorMessage != null) {
      return Text(provider.errorMessage!);
    }
    return ListView.builder(
      itemCount: provider.userSites.length,
      itemBuilder: (context, index) => Text(provider.userSites[index].name),
    );
  },
)

同时确保Provider在MaterialApp外层通过MultiProvider初始化，避免状态被意外重建。

5. 打印日志定位发布版错误 #

在API请求函数中添加日志，通过adb logcat查看发布版运行时的错误信息：

import 'dart:developer';

Future<void> getUserSites() async {
  try {
    isLoading = true;
    notifyListeners();
    log("开始请求用户站点");
    final response = await apiService.fetchUserSites();
    log("请求成功，数据长度：${response.data.length}");
    userSites = response.data;
    errorMessage = null;
  } catch (e) {
    log("请求失败：$e");
    errorMessage = e.toString();
    userSites = [];
  } finally {
    isLoading = false;
    notifyListeners();
    log("状态更新完成，isLoading: $isLoading");
  }
}

执行以下命令查看Flutter相关日志：

adb logcat -s flutter

内容的提问来源于stack exchange，提问作者Alessio Bortolotti