Flutter构建iOS时--profile参数失效，TestFlight中环境模式判断异常

核心原因 #

TestFlight分发的包会经过App Store Connect处理，若构建/上传步骤未严格指定Profile配置，Xcode可能自动将归档切换为Release模式，导致kProfileMode失效。

解决方案 #

1. 严格执行Profile构建流程 #

先清理缓存确保产物纯净：

flutter clean
flutter build ios --profile --no-codesign

--no-codesign跳过本地签名，后续由Xcode统一处理签名，避免配置冲突。

2. 配置Xcode的归档构建模式 #

打开ios/Runner.xcworkspace，按以下步骤操作：

• 顶部工具栏选择目标设备为Any iOS Device (arm64)
• 点击项目名称「Runner」，进入Build Settings，搜索Build Configuration
• 将Archive对应的配置修改为Profile（默认是Release，这是关键）
• 或通过Scheme配置：点击顶部Scheme → Edit Scheme... → 切换到Archive标签，将Build Configuration设为Profile并保存。

3. 本地验证Profile包 #

上传TestFlight前先本地验证：

• 用Xcode将构建的包安装到真机，打印kDebugMode、kProfileMode、kReleaseMode的值，确认kProfileMode为true。
• 本地验证通过后再上传，排除构建环节问题。

4. 改用环境变量区分环境（更可靠） #

如果依赖Flutter内置模式变量仍有问题，推荐用环境变量硬指定环境：

• 构建命令：

  # 开发环境（Profile构建）
  flutter build ios --profile --dart-define=ENV=dev
  # 生产环境（Release构建）
  flutter build ios --release --dart-define=ENV=prod
  

• 代码中读取环境变量：

  final String env = const String.fromEnvironment('ENV', defaultValue: 'dev');
  // 根据env选择对应数据库
  

这种方式完全不受构建模式影响，适配各种分发场景。

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