NestJS中使用Mongoose按username查询用户返回所有用户的问题排查

问题根因与修复方案 #

返回所有用户的核心原因是Mongoose Schema未正确声明username字段，导致查询过滤条件被自动忽略，具体如下：

1. 核心错误：实体字段缺失@Prop装饰器 #

使用@nestjs/mongoose时，只有添加了@Prop()装饰器的类属性，才会被SchemaFactory.createForClass识别并加入生成的MongoDB Schema定义。你当前的User实体所有字段仅添加了用于生成Swagger文档的@ApiProperty()装饰器，没有加@Prop()，最终生成的UserSchema是空结构，没有任何字段定义。
此时执行find({"username": username})查询时，Mongoose默认配置会忽略Schema中未定义的字段过滤条件，实际执行的是无过滤条件的find({})，因此返回所有用户。
修复方法：给所有需要映射到数据库的字段添加@Prop()装饰器：

import { Prop, Schema, SchemaFactory } from "@nestjs/mongoose";
import { ApiProperty } from "@nestjs/swagger";
import { Document } from 'mongoose';

export type UserDocument = User & Document;

@Schema()
export class User {
    @ApiProperty()
    id: string;

    @Prop()
    @ApiProperty()
    username: string;

    @Prop()
    @ApiProperty()
    email : string

    @Prop()
    @ApiProperty()
    password: string;
}

export const UserSchema = SchemaFactory.createForClass(User);

2. 可选优化点 #

• 按用户名查询通常是要获取单个用户，建议将find方法替换为findOne，前者返回符合条件的数组，后者直接返回单个用户对象，更符合业务场景：

findByUsername(username: string) {      
    return this.userModel.findOne({"username": username}).exec();
}

• Service中注入的userModel类型建议替换为Model<UserDocument>，保证类型匹配准确：

constructor(@InjectModel(User.name) private readonly userModel : Model<UserDocument> ){}

• 可通过控制器中打印的username参数确认路由参数是否正常传递，排除参数解析错误的问题。

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