Flutter_Supabase在Android Release模式下无法获取snapshot.data求助

问题现象 #

• Android Debug、Web Debug/Release模式下正常获取数据
• Android Release模式中StreamBuilder的snapshot.hasData始终为false，一直显示加载指示器
• 已尝试关闭minifyEnabled和shrinkResources，使用Codemagic构建仍无效

解决方案 #

1. 先捕获Stream错误（定位根本原因）

当前代码仅判断hasData，忽略了错误状态，Release模式下可能发生了静默错误。修改todos.dart中的StreamBuilder：

builder: (context, snapshot) {
  // 优先处理错误
  if (snapshot.hasError) {
    return Center(
      child: Text('加载失败: ${snapshot.error}'),
    );
  }
  
  if (!snapshot.hasData) {
    return const Center(child: CircularProgressIndicator());
  }

  // 原有数据渲染代码...
}

打包Release版本后，可直接看到具体错误信息，针对性解决。

2. 延迟初始化Stream（避免Supabase未就绪时创建流）

将_stream的初始化从类成员变量移到initState中，确保Supabase完全初始化后再创建流：

class _TodosState extends State<Todos> {
  late final Stream<List<Map<String, dynamic>>> _stream;

  @override
  void initState() {
    super.initState();
    // 等待Supabase初始化完成后创建流
    _stream = Supabase.instance.client
        .from('todos')
        .stream(primaryKey: ['id'])
        .order('created_at', ascending: true);
  }

  // 原有build代码...
}

Release模式下代码执行速度更快，成员变量初始化可能早于Supabase的initialize完成，导致流绑定到未就绪的客户端。

3. 配置Android网络权限与明文流量

若你的Supabase URL为HTTP协议，Android 9+默认禁止明文流量，Debug模式自动允许，但Release模式需手动配置：

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

android:usesCleartextTraffic="true"

2. 确认网络权限已添加（Flutter默认会加，但建议检查）：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

4. 添加Supabase的ProGuard规则（即使关闭混淆也建议配置）

即使设置minifyEnabled false，R8仍可能优化代码导致Supabase核心类被误处理。在android/app/proguard-rules.pro中添加：

-keep class io.supabase.** { *; }
-keep class com.google.gson.** { *; }
-keep class okhttp3.** { *; }
-keep class retrofit2.** { *; }

并确保build.gradle中启用规则：

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

5. 捕获Supabase初始化异常

在main.dart中添加初始化异常捕获，避免静默失败：

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保Flutter绑定初始化
  await dotenv.load(fileName: ".env");
  try {
    await Supabase.initialize(
      url: 'MY_URL_VAL',
      anonKey: 'MY_ANON_KEY_VAL',
    );
    print('Supabase初始化成功');
  } catch (e) {
    print('Supabase初始化失败: $e');
  }
  runApp(const MyApp());
}

Release模式下可将打印替换为专业日志工具（如logger包），方便排查问题。

内容的提问来源于stack exchange，提问作者Kazuya Buma