cube-js/cube · error · UserError

Invalid member expression format: ${error.message || error.t

Error message

Invalid member expression format: ${error.message || error.toString()}

What it means

Input validation in parseInputMemberExpression: the member expression object failed Joi schema validation (inputMemberExpression). It fires when an incoming member expression (e.g. for security contexts or parameterized members) does not match the expected shape of a valid member reference.

Source

Thrown at packages/cubejs-api-gateway/src/query.js:402

    if (f.dimension) {
      res.member = f.dimension;
      delete res.dimension;
    }

    return normalizeDateFilterValues(res, timezone);
  })
);

/**
 * Parse incoming member expression
 * @param {unknown} expression
 * @throws {import('./UserError').UserError}
 * @returns {import('./types/query').InputMemberExpression}
 */
function parseInputMemberExpression(expression) {
  const { error } = inputMemberExpression.validate(expression);
  if (error) {
    throw new UserError(`Invalid member expression format: ${error.message || error.toString()}`);
  }
  return expression;
}

/**
 *
 * @param {Query} query
 * @param {CacheMode} cacheMode
 * @return {Query}
 */
function normalizeQueryCacheMode(query, cacheMode) {
  if (cacheMode !== undefined) {
    query.cacheMode = cacheMode;
  } else if (!query.cache) {
    query.cacheMode = 'stale-if-slow';
  } else {
    query.cacheMode = query.cache;
  }

View on GitHub (pinned to 7d981676b3)

Solutions

1. Send a valid member expression, typically a string like "Cube.name" or an object with the expected member-locator shape.
2. Inspect the Joi error text embedded in the message to see which key or type violated the schema.
3. Check API version: the expression format may differ between client library versions.

When it happens

Trigger: Thrown at packages/cubejs-api-gateway/src/query.js:402 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/48c07e8795d144d3. Report an issue: GitHub.