Flutter在Bitbucket Pipeline中加载ENV文件失败，求解决方案

核心原因 #

你添加的仓库变量仅存在于 Pipeline 的运行环境中，但代码期望从指定路径的 .env 文件读取变量，而这些文件因被 Git 忽略并未同步到 Pipeline 环境，因此加载失败。以下是三种直接可行的修复方案：

方案一：Pipeline 中动态生成对应环境的 .env 文件 #

在构建前根据 ENV_KEY 值，把仓库变量写入到代码期望路径的 .env 文件中：

1. 在 Bitbucket 仓库「Repository settings」→「Repository variables」中，按环境分组添加变量（比如 DEV_API_URL、DEV_APP_KEY、QA_API_URL 等）
2. 修改 bitbucket-pipelines.yml，在构建步骤前生成 .env 文件：

script:
  # 确保目标目录存在
  - mkdir -p local_variables
  # 根据 ENV_KEY 生成对应 .env 文件
  - |
    case "$ENV_KEY" in
      dev)
        echo "API_URL=$DEV_API_URL" > local_variables/.env.dev
        echo "APP_KEY=$DEV_APP_KEY" >> local_variables/.env.dev
        # 其他需要的变量依次追加
        ;;
      qa)
        echo "API_URL=$QA_API_URL" > local_variables/.env.qa
        echo "APP_KEY=$QA_APP_KEY" >> local_variables/.env.qa
        ;;
      prod)
        echo "API_URL=$PROD_API_URL" > local_variables/.env.prod
        echo "APP_KEY=$PROD_APP_KEY" >> local_variables/.env.prod
        ;;
      local)
        echo "API_URL=$LOCAL_API_URL" > local_variables/.env.local
        ;;
    esac
  # 执行 Flutter 构建命令
  - flutter build --dart-define=ENV_KEY=$ENV_KEY

方案二：直接通过 --dart-define 传递变量，废弃 .env 文件读取 #

跳过文件加载逻辑，直接从构建变量中读取环境参数：

1. 修改 Dart 代码，替换原有的 flutter_dotenv 加载逻辑：

// 直接从构建变量中读取，无需加载 .env 文件
final apiUrl = String.fromEnvironment('API_URL', defaultValue: 'http://default.api');
final appKey = String.fromEnvironment('APP_KEY', defaultValue: 'default_key');

2. 在 Pipeline 中直接传递所有需要的变量：

script:
  - |
    case "$ENV_KEY" in
      dev)
        flutter build --dart-define=ENV_KEY=dev \
                      --dart-define=API_URL=$DEV_API_URL \
                      --dart-define=APP_KEY=$DEV_APP_KEY
        ;;
      qa)
        flutter build --dart-define=ENV_KEY=qa \
                      --dart-define=API_URL=$QA_API_URL \
                      --dart-define=APP_KEY=$QA_APP_KEY
        ;;
      # 其他环境同理
    esac

方案三：使用 Bitbucket Secure Files 上传 .env 文件并下载 #

如果 .env 变量过多，不想逐个在 Pipeline 中编写，可直接上传文件到仓库：

1. 在 Bitbucket 仓库「Repository settings」→「Secure files」中，上传各个环境的 .env 文件（比如 .env.dev、.env.qa）
2. 在 Pipeline 中下载对应文件到指定路径：

script:
  # 确保目标目录存在
  - mkdir -p local_variables
  # 根据 ENV_KEY 下载对应 secure file
  - |
    case "$ENV_KEY" in
      dev)
        pipe: atlassian/secure-file-download:0.6.0
          variables:
            SECURE_FILE: '.env.dev'
            DESTINATION: 'local_variables/.env.dev'
        ;;
      qa)
        pipe: atlassian/secure-file-download:0.6.0
          variables:
            SECURE_FILE: '.env.qa'
            DESTINATION: 'local_variables/.env.qa'
        ;;
      # 其他环境同理
    esac
  # 执行构建命令
  - flutter build --dart-define=ENV_KEY=$ENV_KEY

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