TypeScript中Mongoose查询结果解构password遇TS2339错误求助

错误原因 #

TS报错核心是User.findById()返回的类型为(Document<unknown, any, IUser> & IUser & { _id: ObjectId; }) | null，TypeScript无法确保解构时user一定不为null，联合类型中的null导致无法直接访问password属性。

解决方案 #

方案1：提前终止null分支（最安全） #

在if (!user)的判断分支中添加return，让TypeScript明确后续代码里user不可能为null：

// 先导入Express的类型（替换any更规范）
import { Request, Response } from "express";

router.get("/:id", verifyToken, async (req: Request, res: Response) => {
    const user = await UserModel.findById(req.params.id);
    if (!user) {
        return res.status(404).json({ message: "User not found" });
    }

    const { password, ...other } = user;
    res.status(200).json(other);
});

方案2：非空断言（快速临时解决） #

如果你能确保业务逻辑中user此时不可能为null，可以用非空断言!强制告诉TypeScript：

const { password, ...other } = user!;

注意：仅在你100%确认user不为null时使用，否则可能引发运行时错误。

方案3：完善接口继承（更严谨的类型定义） #

让IUser继承Mongoose的Document接口，使返回类型更清晰：

import mongoose, { Document } from "mongoose";

interface IUser extends Document {
    username: string;
    password: string;
    email: string;
    isAdmin: boolean;
}

const userSchema = new mongoose.Schema<IUser>({
    // 原Schema内容不变
});

export const UserModel = mongoose.model<IUser>("User", userSchema);

之后配合方案1的提前return，就能彻底解决类型报错问题。

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