Flutter：如何在runApp前使用环境变量 解决String.fromEnvironment报错

报错根因 #

String.fromEnvironment 是Dart提供的编译期常量构造器，取值在编译阶段就会被固化替换，而非应用运行时动态读取系统环境变量。受这个特性限制，它仅能在要求常量表达式的上下文环境中使用。原代码将环境变量读取逻辑放在if分支内部的普通变量赋值位置，不属于常量表达式的适用场景，因此会触发「仅可作为常量构造器使用」的报错。

方案1：将环境变量常量提前到顶层声明（推荐） #

把环境变量的读取逻辑移到main函数外部，通过const声明为顶层常量，完全符合它的使用规则，编译阶段就会自动完成值的替换，后续在逻辑分支里直接引用即可：

import 'package:flutter/foundation.dart' show kIsWeb;  

// 编译期常量，在打包阶段就会被替换为传入的配置值
const String _facebookAppId = String.fromEnvironment(
  'FACEBOOK_APP_ID',
  defaultValue: 'somedefaultvalue',
);

void main() {
  // 判断当前运行环境是否为Web端
  if (kIsWeb) {
    FacebookAuth.instance.webInitialize(
      appId: _facebookAppId,
      cookie: true,
      xfbml: true,
      version: "v9.0",
    );
  }
  runApp(MyApp());
}

对应的传参方式 #

启动调试或打包时，通过--dart-define参数传入实际的APP_ID即可：

• 本地Web调试命令：flutter run -d chrome --dart-define=FACEBOOK_APP_ID=你的实际Facebook应用ID
• Web端打包命令：flutter build web --dart-define=FACEBOOK_APP_ID=你的实际Facebook应用ID

方案2：在main函数起始位置声明常量 #

如果不想将常量暴露为顶层变量，也可以在main函数最起始的位置、所有运行时分支判断之前，通过const声明读取环境变量，注意不要把这行代码放到if等运行时才进入的分支内部，否则还是会触发同类报错：

import 'package:flutter/foundation.dart' show kIsWeb;  

void main() {
  // 在分支判断之前完成编译期常量的读取
  const appId = String.fromEnvironment(
    'FACEBOOK_APP_ID',
    defaultValue: 'somedefaultvalue',
  );

  if (kIsWeb) {
    FacebookAuth.instance.webInitialize(
      appId: appId,
      cookie: true,
      xfbml: true,
      version: "v9.0",
    );
  }
  runApp(MyApp());
}

• String.fromEnvironment 读取的配置值无法在应用运行过程中动态修改，所有配置必须在编译/启动阶段通过--dart-define参数传入。
• 不要在运行时执行的循环、普通逻辑分支、非const标注的函数内部使用String.fromEnvironment，否则会触发同类报错。
• 注意不要混淆String.fromEnvironment和运行时读取系统环境变量的逻辑，前者完全是编译期替换机制，应用运行后不会再去读取系统的环境变量配置。
• 如果需要在非Web端也使用同一个APP_ID做配置，直接引用提前声明的常量即可，不需要重复写读取逻辑。

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