创建User Schema时遇ReferenceError：初始化前无法访问'UserSchema'

问题场景 #

在为User Schema添加friends字段前所有功能正常，添加后触发以下报错：

ReferenceError: Cannot access 'UserSchema' before initialization
报错位置：/Users/noahduran/Langiddy_msg/server/models/User.js:51:16

错误原因 #

你在定义UserSchema时，直接将friends字段的类型设置为[UserSchema]，此时UserSchema还未完成初始化，导致引用错误。此外，在MongoDB的设计逻辑中，好友关系更适合用文档引用而非嵌套文档——嵌套会造成数据冗余，且用户信息更新时，好友列表中的嵌套数据无法同步更新。

解决方案 #

将friends字段改为引用类型，使用mongoose.Schema.Types.ObjectId关联User模型：

修改后的完整代码 #

const mongoose = require('mongoose');
const bcrypt = require('bcrypt')

const UserSchema = new mongoose.Schema({
    fullName: {
        type: String,
    },
    email: {
        type: String,
        unique: true,
        required: true,
    },
    password: {
        type: String,
        required: true,
    },
    image: {
        type: String,
    },
    pictures: {
        type: String,
    },
    nickName: {
        type: String
    },
    relationshipStatus: {
        type: String,
    },
    nextTrip: {
        type: String,
    },
    reasonTravel: {
        type: String,
    },
    language: {
        type: String,
    },
    lastLocation: {
        type: String,
    },
    loveLanguage: {
        type: String,
    },
    travelGoals: {
        type: String,
    },
    education: {
        type: String,
    },
    // 核心修改：用ObjectId引用User模型
    friends: [{
        type: mongoose.Schema.Types.ObjectId,
        ref: 'User'
    }]
}, { timestamps: true });

UserSchema.pre('save', function(next){
    const user = this;
    if(!user.isModified('password')){
        return next();
    }
    bcrypt.genSalt(10, (err,salt)=>{
        if(err){
            return next(err);
        }
        bcrypt.hash(user.password, salt, (err, hash)=>{
            if(err){
                return next(err)
            }
            user.password = hash;
            next();
        })
    })
})
UserSchema.methods.comparePassword = function(candidatePassword){
    const user = this;
    return new Promise ((resolve, reject)=>{
        bcrypt.compare(candidatePassword, user.password, (err, isMatch)=>{
            if(err){
                return reject(err);
            }
            if(!isMatch){
                return reject(false);
            }
            resolve(true);
        })
    })
}

const User = mongoose.model('User', UserSchema);
module.exports = User;

使用说明 #

查询用户时，可通过populate方法将好友ID对应的完整用户信息填充出来，示例代码：

// 查询指定用户并加载其好友详情
User.findById(userId).populate('friends').exec((err, user) => {
    if (err) {
        // 处理错误逻辑
    }
    // user.friends 此时为完整的好友用户文档数组
});

内容的提问来源于stack exchange，提问作者Noah Duran