{"record":{"id":"8eecf01e233fd39c","repo":"cube-js/cube","slug":"unsupported-env-variable-key","errorCode":null,"errorMessage":"Unsupported env variable: \"${key}\"","messagePattern":"Unsupported env variable: \"(.+?)\"","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cubejs-backend-shared/src/env.ts","lineNumber":2102,"sourceCode":"    .asBoolStrict(),\n  accessPolicyMaskString: () => get('CUBEJS_ACCESS_POLICY_MASK_STRING')\n    .asString(),\n  accessPolicyMaskTime: () => get('CUBEJS_ACCESS_POLICY_MASK_TIME')\n    .asString(),\n  accessPolicyMaskBoolean: () => get('CUBEJS_ACCESS_POLICY_MASK_BOOLEAN')\n    .asString(),\n  accessPolicyMaskNumber: () => get('CUBEJS_ACCESS_POLICY_MASK_NUMBER')\n    .asString(),\n};\n\ntype Vars = typeof variables;\n\nexport function getEnv<T extends keyof Vars>(key: T, opts?: Parameters<Vars[T]>): ReturnType<Vars[T]> {\n  if (key in variables) {\n    return variables[key](opts);\n  }\n\n  throw new Error(\n    `Unsupported env variable: \"${key}\"`,\n  );\n}\n\n// trigger warning\ngetEnv('transpilationWorkerThreads');\n\nexport function isDockerImage(): boolean {\n  return Boolean(process.env.CUBEJS_DOCKER_IMAGE_TAG);\n}\n","sourceCodeStart":2084,"sourceCodeEnd":2113,"githubUrl":"https://github.com/cube-js/cube/blob/7d981676b36392fec34088b9afab6bdcad40207c/packages/cubejs-backend-shared/src/env.ts#L2084-L2113","documentation":"Unknown-key guard in getEnv (cubejs-backend-shared/env.ts): the requested env accessor key is not present in the `variables` registry. This fires when code (often a driver or package) calls getEnv with a key the installed env.ts does not define — usually a version mismatch between packages, not a user environment problem.","triggerScenarios":"Thrown at packages/cubejs-backend-shared/src/env.ts:2102 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the exact getEnv key spelling against the CUBEJS_* names exported in env.ts.","Align package versions: a driver referencing a newer env variable than the installed cubejs-backend-shared defines will trigger this.","After upgrading packages, run yarn install and rebuild so the env registry matches all consumers."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"7d981676b36392fec34088b9afab6bdcad40207c","analyzedAt":"2026-09-02T03:45:10.400Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T15:18:49.778Z"}