如何在Flutter Web的GitHub Actions部署中于main.dart使用密钥

直接放弃用dotenv读取本地.env的方式，改用Flutter的编译时环境变量注入，彻底避免依赖.env文件，同时安全使用GitHub Secrets里的密钥。

1. 项目代码改造 #

在你的Flutter项目里创建一个lib/env.dart文件，用String.fromEnvironment定义需要的环境变量：

// lib/env.dart
class Env {
  // 这里的key要和后面编译时传入的--dart-define参数名一致
  static const apiUrl = String.fromEnvironment('API_URL');
  static const appKey = String.fromEnvironment('APP_KEY');
  // 按需添加其他环境变量
}

然后在main.dart里直接调用这些常量，替换原来的dotenv.env['XXX']：

// main.dart
import 'env.dart';

void main() {
  // 直接使用注入的环境变量
  print('API地址: ${Env.apiUrl}');
  // ...其他代码
}

2. 修改GitHub Actions工作流 #

更新.github/workflows/workflow.yml里的build步骤，把GitHub Secrets通过--dart-define参数直接传入flutter build命令，完全不需要生成.env文件：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      # ...其他步骤（拉取代码、安装Flutter等）
      - name: 构建Flutter Web
        run: flutter build web --release 
          --dart-define=API_URL=${{ secrets.API_URL }} 
          --dart-define=APP_KEY=${{ secrets.APP_KEY }}
          # 有更多环境变量就继续加--dart-define参数

3. 本地测试（可选） #

本地开发时，不需要.env文件，直接用flutter run命令传入测试用的环境变量即可：

flutter run --dart-define=API_URL=http://localhost:3000 --dart-define=APP_KEY=test_key

为什么这能解决你的问题？ #

• 编译时注入的环境变量会直接打包进Web产物里，运行时不需要读取任何本地文件，彻底消除了对.env的依赖，部署不会再失败。
• GitHub Secrets里的密钥只会在Action运行时被注入，不会出现在仓库代码或构建产物的明文里，完全避免了安全风险。

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