如何在GitHub Action中配置环境密钥并供项目.env访问？

你当前的配置存在两个核心问题：一是把环境变量仅配置在了setup-node步骤中，导致后续的npm命令步骤无法读取到这个变量；二是如果项目依赖.env文件读取变量，Action流程中并没有生成对应的.env文件。以下是具体的解决办法：

方案一：全局注入环境变量（适合支持读取系统环境变量的项目） #

将环境变量配置在job级别，这样整个build任务下的所有步骤都能访问到该变量：

name: Node.js CI

on:
  push:
    branches: ['master']
  pull_request:
    branches: ['master']

jobs:
  build:
    runs-on: ubuntu-latest
    # 把环境变量放在job级别，所有步骤均可读取
    env:
      MONGODB_PASSWORD: ${{ secrets.MONGODB_PASSWORD }}
    strategy:
      matrix:
        node-version: [12.x, 14.x, 16.x]

    steps:
      - uses: actions/checkout@v3
      - name: Use Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      - run: npm ci
      - run: npm run build --if-present
      - run: npm run lint
      - run: npm run test
      - run: npm run test:e2e

如果项目用dotenv库读取变量，可以在本地的.env.example中添加MONGODB_PASSWORD=${MONGODB_PASSWORD}，配合dotenv-expand库，就能自动将系统环境变量的值映射到.env的占位符中。

方案二：在Action中生成.env文件（适合必须读取.env文件的项目） #

添加一个步骤生成.env文件，直接把密钥写入其中（该文件仅在本次Action运行中存在，不会提交到仓库）：

name: Node.js CI

on:
  push:
    branches: ['master']
  pull_request:
    branches: ['master']

jobs:
  build:
    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [12.x, 14.x, 16.x]

    steps:
      - uses: actions/checkout@v3
      # 新增步骤：生成.env文件
      - name: Generate .env file
        run: |
          echo "MONGODB_PASSWORD=${{ secrets.MONGODB_PASSWORD }}" >> .env
          # 如果有其他环境变量，继续用echo追加
      - name: Use Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      - run: npm ci
      - run: npm run build --if-present
      - run: npm run lint
      - run: npm run test
      - run: npm run test:e2e

额外检查项 #

• 确认GitHub仓库的「Settings → Secrets and variables → Actions」中，确实添加了名为MONGODB_PASSWORD的密钥，且拼写完全一致（大小写敏感）。
• 如果是通过fork仓库发起的PR触发Action，GitHub出于安全限制，不会让这类PR访问原仓库的Secrets，这种情况需要手动在fork仓库中添加对应的密钥。

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