React Native应用如何避免误部署测试环境？实现环境完全隔离

以下是几个能彻底隔离测试/生产环境、避免手动切换失误的落地方案，都是实际项目中验证过的：

1. 环境变量+构建脚本自动化 #

直接用环境变量控制API地址，配合打包脚本自动加载对应配置，彻底告别手动修改：

• 在项目根目录创建.env.dev和.env.prod文件，分别写入：

  # .env.dev
  API_URL=https://dev-api.example.com
  

  # .env.prod
  API_URL=https://prod-api.example.com
  

• 使用react-native-config库读取环境变量（也可直接用Node环境变量方案），代码里直接取值：

  import Config from 'react-native-config';
  const BASE_URL = Config.API_URL;
  

• 在package.json中添加对应环境的打包脚本：

  "scripts": {
    "build:android:prod": "ENVFILE=.env.prod react-native run-android --variant=release",
    "build:ios:prod": "ENVFILE=.env.prod xcodebuild -workspace ios/YourApp.xcworkspace -scheme YourApp -configuration Release archive"
  }
  

  以后打包生产版本直接运行对应脚本，无需手动修改任何代码。

2. 利用原生构建变体隔离 #

借助Android和iOS的原生构建系统，让不同环境的配置完全独立：

Android端 #

在android/app/build.gradle中配置productFlavors：

android {
    ...
    productFlavors {
        dev {
            resValue "string", "API_URL", "https://dev-api.example.com"
        }
        prod {
            resValue "string", "API_URL", "https://prod-api.example.com"
        }
    }
}

代码中通过原生模块读取：

import { NativeModules } from 'react-native';
const BASE_URL = NativeModules.RNConfig.API_URL;

打包时选择prodRelease变体即可。

iOS端 #

在Xcode中创建Prod配置（复制Release配置），然后在Info.plist中添加API_URL字段，给不同配置赋值不同地址。代码中读取：

import { NativeModules } from 'react-native';
const BASE_URL = NativeModules.InfoPlist.API_URL;

打包时选择Prod配置，完全和测试环境隔离。

3. 部署前校验钩子 #

给生产打包脚本加前置校验，确保环境配置正确才允许继续：

• 写一个简单的校验脚本scripts/check-prod-env.js：

const fs = require('fs');
const envContent = fs.readFileSync('.env', 'utf8');
if (!envContent.includes('API_URL=https://prod-api.example.com')) {
  console.error('❌ 当前不是生产环境配置，终止打包！');
  process.exit(1);
}

• 在package.json中添加前置脚本：

"scripts": {
  "prebuild:android:prod": "node scripts/check-prod-env.js",
  "build:android:prod": "react-native run-android --variant=release"
}

如果环境配置不对，打包会直接报错终止，避免误操作。

4. Git分支策略强制隔离 #

用分支规则从流程上杜绝错误：

• 维护dev和main（或prod）两个核心分支：
  • dev分支默认用测试环境配置，只用于开发和内部测试；
  • main分支固定用生产环境配置，禁止直接在该分支修改配置，只能通过PR合并经过测试的代码。
• 生产打包必须在main分支执行，从根源上避免加载测试配置。

推荐组合方案 #

把环境变量脚本+Git分支策略结合起来：用分支保证代码基线的正确性，用脚本自动加载对应环境的配置，再加上前置校验做最后一道防线，就能实现测试和生产环境的完全隔离，彻底解决手动切换的失误问题。

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