如何在Ballerina的bal test中针对不同环境配置变量？

针对本地与GitHub Actions测试需要不同配置变量的场景，结合你遇到的bal test不支持-Ckey=value、环境变量无法直接覆盖Config.toml的问题，推荐以下几个实用方案：

方案1：Config.toml中嵌入环境变量占位符 #

利用Ballerina配置的环境变量插值特性，在tests/Config.toml中为变量设置默认值+环境变量 fallback，既能保留本地测试的默认配置，又能让CI环境通过环境变量覆盖：

示例tests/Config.toml内容：

[testConfig]
apiUrl = "${env:TEST_API_URL, default=\"http://localhost:8080\"}"
apiKey = "${env:TEST_API_KEY, default=\"local-test-key\"}"

• 本地测试：无需额外操作，直接运行bal test会使用默认值
• GitHub Actions配置：在 workflow 文件中设置环境变量即可覆盖

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Ballerina
        uses: ballerina-platform/setup-ballerina@v1
      - name: Run tests
        env:
          TEST_API_URL: "https://ci-api.example.com"
          TEST_API_KEY: "${{ secrets.CI_API_KEY }}"
        run: bal test

优势：无需修改测试代码，配置文件统一管理，CI环境只需设置环境变量，侵入性最低

方案2：多配置文件切换 #

为本地和CI环境分别创建独立的配置文件，通过环境变量指定测试时加载的配置文件：

1. 创建两个配置文件：

   • tests/Config.toml：本地测试配置
   • tests/Config.ci.toml：GitHub Actions测试配置

2. 运行测试时指定配置文件：

   • 本地：直接运行bal test（默认加载tests/Config.toml）
   • GitHub Actions：通过BALLERINA_CONFIG_FILE环境变量指定CI配置文件

jobs:
  test:
    steps:
      # ... 其他步骤
      - name: Run CI tests
        env:
          BALLERINA_CONFIG_FILE: "./tests/Config.ci.toml"
        run: bal test

优势：不同环境的配置完全隔离，适合配置项较多、差异较大的场景，避免配置文件中出现大量占位符

方案3：测试代码中动态读取环境变量 #

如果仅需少量变量区分环境，可直接在测试代码中读取环境变量并设置默认值，跳过配置文件的限制：

示例测试代码片段：

import ballerina/io;
import ballerina/os;

@test:Config {}
function testApiCall() {
    string apiUrl = os:getEnv("TEST_API_URL") ?: "http://localhost:8080";
    string apiKey = os:getEnv("TEST_API_KEY") ?: "local-test-key";
    
    // 使用apiUrl和apiKey执行测试逻辑
    io:println("Using API URL: ", apiUrl);
}

• 本地测试：未设置环境变量时使用默认值
• GitHub Actions：在 workflow 中设置对应环境变量即可

优势：无需修改配置文件，适合快速实现少量变量的环境区分，代码逻辑更直观

方案选择建议 #

• 若配置项较多且需要统一管理：优先选方案1
• 若本地与CI配置差异极大、需要完全隔离：选方案2
• 若仅需少数变量区分环境：选方案3

内容的提问来源于stack exchange，提问作者Kavindu Gimhan Zoysa