Github Actions中E2E测试套件无法读取环境变量的问题

常见原因及修复方案 #

1. 环境变量未跨shell进程传递 #

如果你的工作流步骤是将变量设置和测试执行拆分成了两个独立的run块，比如：

- name: Set JWT secret
  run: export JWT_SECRET=${{ secrets.JWT_SECRET }}
- name: Run E2E tests
  run: npm run test:e2e

这种写法会导致变量丢失——因为每个run步骤都是独立的shell进程，环境变量无法跨进程共享。

修复：要么把设置变量和执行测试放在同一个run块内，要么直接用Github Actions的env字段定义变量（推荐这种跨进程兼容的方式）：

# 步骤级定义（仅当前步骤生效）
- name: Run E2E tests
  env:
    JWT_SECRET: ${{ secrets.JWT_SECRET }}
  run: npm run test:e2e

# 全局定义（整个工作流所有步骤生效）
env:
  JWT_SECRET: ${{ secrets.JWT_SECRET }}
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Run E2E tests
        run: npm run test:e2e

2. 测试进程启动前未加载变量 #

部分测试框架或env-var包会在进程启动时一次性读取所有环境变量，如果你是在测试运行过程中通过shell临时export变量，测试进程根本捕获不到。

修复：必须确保变量在测试进程启动前就被注入到环境中，使用Github Actions的env字段是最直接的方式，它会在步骤执行前就把变量注入到当前shell的环境中。

3. 密钥配置或语法错误 #

如果secrets.JWT_SECRET本身未配置，或者传递时出现语法问题（比如多余引号），也会导致变量为空。可以先添加调试步骤验证：

- name: Debug JWT secret
  env:
    JWT_SECRET: ${{ secrets.JWT_SECRET }}
  run: echo "JWT_SECRET length: ${#JWT_SECRET}"

如果输出长度为0，说明你需要去仓库的Settings > Secrets and variables > Actions页面，正确添加JWT_SECRET密钥。

4. Windows Runner的shell差异 #

如果工作流使用Windows环境的runner，export命令不生效，需要用set命令，但更省心的方式还是直接用Github Actions的env字段，它是跨平台兼容的。

总结 #

最可靠的解决方式是通过Github Actions的env字段（步骤级或全局）传递环境变量，避免依赖shell临时设置导致的进程隔离问题，同时确保仓库密钥配置正确。

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