如何在Flutter/Supabase中实现开发与生产环境的区分处理？

针对开发/测试、生产两个Supabase项目的场景，以下是几种实用的多环境配置方法：

方法一：Dart Define 环境变量（轻量首选） #

这种方式无需额外依赖，直接通过编译参数传递环境配置，适合简单场景。

1. 创建配置类
   在项目中新建lib/config/app_config.dart，定义从环境变量读取配置的类：

class AppConfig {
  // 从编译参数中读取Supabase地址和匿名密钥
  static final String supabaseUrl = const String.fromEnvironment('SUPABASE_URL');
  static final String supabaseAnonKey = const String.fromEnvironment('SUPABASE_ANON_KEY');
}

2. 初始化Supabase
   在main.dart中使用配置类初始化：

import 'package:flutter/material.dart';
import 'package:supabase_flutter/supabase_flutter.dart';
import 'config/app_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await Supabase.initialize(
    url: AppConfig.supabaseUrl,
    anonKey: AppConfig.supabaseAnonKey,
  );
  
  runApp(const MyApp());
}

3. 运行/打包时指定环境

• 开发/测试环境：

flutter run --dart-define=SUPABASE_URL="你的开发Supabase URL" --dart-define=SUPABASE_ANON_KEY="你的开发匿名密钥"

• 生产环境打包：

flutter build apk --dart-define=SUPABASE_URL="你的生产Supabase URL" --dart-define=SUPABASE_ANON_KEY="你的生产匿名密钥"

方法二：Flutter Flavorizr 插件（复杂场景推荐） #

如果需要更精细化的环境管理（比如不同应用图标、名称），可以用专门的多环境插件。

1. 添加依赖
   在pubspec.yaml中加入：

dev_dependencies:
  flutter_flavorizr: ^2.2.0

执行flutter pub get安装依赖。

2. 生成环境配置
   运行命令生成flavor配置文件：

flutter pub run flutter_flavorizr

按照提示选择dev和prod两个环境。

3. 配置各环境Supabase参数
   在生成的lib/flavors/目录下，分别创建dev.dart和prod.dart：

// dev.dart
class DevConfig {
  static const supabaseUrl = "你的开发Supabase URL";
  static const supabaseAnonKey = "你的开发匿名密钥";
}

// prod.dart
class ProdConfig {
  static const supabaseUrl = "你的生产Supabase URL";
  static const supabaseAnonKey = "你的生产匿名密钥";
}

4. 根据环境初始化Supabase
   修改main.dart：

import 'package:flutter/material.dart';
import 'package:supabase_flutter/supabase_flutter.dart';
import 'package:flutter_flavorizr/flutter_flavorizr.dart';
import 'flavors/dev.dart';
import 'flavors/prod.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  late String supabaseUrl;
  late String supabaseAnonKey;
  
  switch (FlavorConfig.instance.name) {
    case 'dev':
      supabaseUrl = DevConfig.supabaseUrl;
      supabaseAnonKey = DevConfig.supabaseAnonKey;
      break;
    case 'prod':
      supabaseUrl = ProdConfig.supabaseUrl;
      supabaseAnonKey = ProdConfig.supabaseAnonKey;
      break;
    default:
      throw Exception('未知环境标识');
  }
  
  await Supabase.initialize(url: supabaseUrl, anonKey: supabaseAnonKey);
  runApp(const MyApp());
}

5. 切换环境运行/打包

• 开发环境：flutter run --flavor dev
• 生产环境打包：flutter build apk --flavor prod

方法三：本地配置文件（适合需要动态切换的场景） #

通过JSON配置文件存储环境参数，适合需要在应用内切换环境的调试场景。

1. 创建配置文件
   在assets/env/目录下创建dev.json和prod.json：

// dev.json
{
  "supabaseUrl": "你的开发Supabase URL",
  "supabaseAnonKey": "你的开发匿名密钥"
}

// prod.json
{
  "supabaseUrl": "你的生产Supabase URL",
  "supabaseAnonKey": "你的生产匿名密钥"
}

2. 声明资源
   在pubspec.yaml中添加资源路径：

flutter:
  assets:
    - assets/env/dev.json
    - assets/env/prod.json

3. 加载配置的服务类
   创建lib/services/config_service.dart：

import 'dart:convert';
import 'package:flutter/services.dart';

class ConfigService {
  late String supabaseUrl;
  late String supabaseAnonKey;

  Future<void> loadConfig() async {
    // 通过编译参数判断当前环境
    final isProduction = const bool.fromEnvironment('PRODUCTION');
    final assetPath = isProduction ? 'assets/env/prod.json' : 'assets/env/dev.json';
    
    final jsonString = await rootBundle.loadString(assetPath);
    final jsonData = jsonDecode(jsonString);
    
    supabaseUrl = jsonData['supabaseUrl'];
    supabaseAnonKey = jsonData['supabaseAnonKey'];
  }
}

4. 初始化Supabase
   修改main.dart：

import 'package:flutter/material.dart';
import 'package:supabase_flutter/supabase_flutter.dart';
import 'services/config_service.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  final configService = ConfigService();
  await configService.loadConfig();
  
  await Supabase.initialize(
    url: configService.supabaseUrl,
    anonKey: configService.supabaseAnonKey,
  );
  
  runApp(const MyApp());
}

5. 指定环境运行

• 开发环境：flutter run --dart-define=PRODUCTION=false
• 生产环境：flutter run --dart-define=PRODUCTION=true

注意事项 #

• 所有包含密钥的配置文件或参数，都要加入.gitignore，避免泄露到版本库
• 生产打包前务必验证Supabase配置是否正确，避免连接到测试环境
• 可以在开发环境的UI上添加明显标识（比如右上角的"DEV"标签），防止混淆环境

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