Automattic/mongoose · error · MongooseError

refPath `${refPath}` must not be excluded in projection, got

Error message

refPath `${refPath}` must not be excluded in projection, got ${util.inspect(queryProjection)}

What it means

Error "refPath `${refPath}` must not be excluded in projection, got ${util.inspect(queryProjection)}" thrown in Automattic/mongoose.

Source

Thrown at lib/helpers/populate/modelNamesFromRefPath.js:22

const isPathExcluded = require('../projection/isPathExcluded');
const lookupLocalFields = require('./lookupLocalFields');
const mpath = require('mpath');
const util = require('util');
const utils = require('../../utils');

const hasNumericPropRE = /(\.\d+$|\.\d+\.)/g;

module.exports = function modelNamesFromRefPath(refPath, doc, populatedPath, modelSchema, queryProjection) {
  if (refPath == null) {
    return [];
  }

  if (typeof refPath !== 'string') {
    throw new MongooseError('`refPath` must be a string or a function that returns a string, got ' + util.inspect(refPath));
  }

  if (queryProjection != null && isPathExcluded(queryProjection, refPath)) {
    throw new MongooseError('refPath `' + refPath + '` must not be excluded in projection, got ' +
      util.inspect(queryProjection));
  }

  // If populated path has numerics, the end `refPath` should too. For example,
  // if populating `a.0.b` instead of `a.b` and `b` has `refPath = a.c`, we
  // should return `a.0.c` for the refPath.

  if (hasNumericPropRE.test(populatedPath)) {
    const chunks = populatedPath.split(hasNumericPropRE);

    if (chunks[chunks.length - 1] === '') {
      throw new Error('Can\'t populate individual element in an array');
    }

    let _refPath = '';
    let _remaining = refPath;
    // 2nd, 4th, etc. will be numeric props. For example: `[ 'a', '.0.', 'b' ]`
    for (let i = 0; i < chunks.length; i += 2) {

View on GitHub (pinned to 49cdab0136)

When it happens

Trigger: Thrown at lib/helpers/populate/modelNamesFromRefPath.js:22 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Automattic/mongoose@49cdab0136 (2026-08-21). Data as JSON: /api/errors/278bb95f7d47aa29. Report an issue: GitHub.