usebruno/bruno · error · BrunoError

Invalid environment: missing or invalid variables array

Error message

Invalid environment: missing or invalid variables array

What it means

Thrown by validateBrunoEnvironment() after the top-level object check passes but env.variables is not an array. Bruno requires every environment to expose its variables as a JSON array, even an empty one.

Source

Thrown at packages/bruno-app/src/utils/importers/bruno-environment.js:10

import { BrunoError } from 'utils/common/error';
import { buildEnvVariable, dedupeImportedSecrets } from 'utils/environments';

const validateBrunoEnvironment = (env) => {
  if (!env || typeof env !== 'object') {
    throw new BrunoError('Invalid environment: expected an object');
  }

  if (!Array.isArray(env.variables)) {
    throw new BrunoError('Invalid environment: missing or invalid variables array');
  }

  // Validate each variable
  env.variables.forEach((variable, index) => {
    if (!variable || typeof variable !== 'object') {
      throw new BrunoError(`Invalid variable at index ${index}: expected an object`);
    }
    if (!variable.name || typeof variable.name !== 'string') {
      throw new BrunoError(`Invalid variable at index ${index}: missing or invalid name`);
    }
  });

  const variables = env.variables.map((envVariable) => buildEnvVariable({ envVariable, withUuid: true }));

  return {
    name: env.name || 'Imported Environment',
    variables: dedupeImportedSecrets(variables),
    color: env.color

View on GitHub (pinned to 9bdd81c7bd)

Solutions

1. Rewrite variables as an array: [{"name":"BASE_URL","value":"https://api","enabled":true}].
2. If the environment has no variables, use "variables": [].
3. Confirm each element follows Bruno's variable shape before re-importing.

Example fix

// before
{
  "name": "Prod",
  "variables": { "BASE_URL": "https://api" }
}
// after
{
  "name": "Prod",
  "variables": [
    { "name": "BASE_URL", "value": "https://api", "enabled": true }
  ]
}

if (!Array.isArray(env?.variables)) {
  throw new Error('Environment variables must be an array');
}

function hasVariablesArray(env) {
  return isBrunoEnvironment(env) && Array.isArray(env.variables);
}

try {
  validateBrunoEnvironment(env);
} catch (err) {
  if (err.message.includes('missing or invalid variables array')) {
    env.variables = env.variables ? [] : [];
  }
  throw err;
}

When it happens

Trigger: An environment object whose variables field is missing, null, a string, a number, an object/Map shape, or any non-array value. For example { "name": "Prod", "variables": { "BASE_URL": "..." } } (object instead of array).

Common situations: Hand-authoring an environment with a key-value map instead of an array of {name,value,enabled} objects, importing a partial export, or migrating from a Postman environment whose 'values' array was renamed incorrectly.

Related errors

• Invalid environment: expected an object
• Invalid variable at index ${index}: expected an object
• Invalid variable at index ${index}: missing or invalid name
• No files provided
• Error in environment ${index + 1} from ${fileName}: ${err.me

AI-assisted analysis of usebruno/bruno@9bdd81c7bd (2026-08-13). Data as JSON: /api/errors/786ca2aa4a6bcb3b. Report an issue: GitHub.