MERN栈Mongoose填充owner字段时出现读取null的TypeError问题

错误根源 #

你遇到的TypeError: Cannot read properties of null (reading 'username')是因为某个Lead文档的owner字段关联的User记录已被删除，导致Mongoose的populate方法无法找到对应的用户，返回了null，而前端代码直接尝试访问null的username属性。

另外，后端Admin查询的populate配置存在逻辑错误：你在populate的options里使用sort: { recieveddate: -1 }，但recieveddate是Lead文档的字段，不是User的字段，这个排序规则不会生效，反而可能干扰查询逻辑。

前端紧急修复 #

先修复前端报错，确保即使owner为null也不会崩溃：

将渲染username的代码修改为：

<StyledTableCell align="center">{row.owner?.username || 'N/A'}</StyledTableCell>

使用**可选链操作符?.**避免在row.owner为null/undefined时访问属性报错，同时用|| 'N/A'兜底显示默认值。

后端代码优化与修复 #

1. 修正排序逻辑 #

Admin查询时，应该对Lead的recieveddate排序，而非关联的User排序。修改后端路由代码：

router.get('/', auth, async (req, res) => {
  try {
    const user = await User.findById(req.user.id);
    if (user.isadmin) {
      // 对Lead的recieveddate倒序排列，而非User字段
      const leads = await Lead.find({})
        .populate('owner')
        .sort({ recieveddate: -1 });
      res.json(leads);
    } else {
      const leads = await Lead.find({ owner: user._id })
        .sort({ recieveddate: -1 });
      res.json(leads);
    }
  } catch (err) {
    console.error(err.message);
    res.status(500).send('Server Error');
  }
});

• 改用async/await替代回调和then，代码更清晰，错误处理更统一。
• 将sort移到Lead查询链上，确保按Lead的recieveddate倒序排列。

2. 防止关联用户缺失的问题 #

可以通过两种方式避免owner为null的情况：

• 模型层限制：在Lead模型中设置owner字段为必填，确保新建Lead时必须关联有效用户：

// Lead模型示例
const LeadSchema = new mongoose.Schema({
  // 其他字段...
  owner: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'User',
    required: true // 添加该行
  }
});

• 查询时过滤：如果允许存在无owner的Lead，查询时可过滤掉owner为null的记录：

// Admin查询时过滤掉owner为null的Lead
const leads = await Lead.find({ owner: { $ne: null } })
  .populate('owner')
  .sort({ recieveddate: -1 });

额外建议 #

• 定期检查数据库中Lead文档的owner字段，清理关联失效的记录。
• 删除User记录时，添加前置逻辑：将关联Lead的owner字段设置为默认管理员，或直接删除对应Lead，避免出现悬空关联。

内容的提问来源于stack exchange，提问作者Sajeel Ahmad