Nest.js中TypeORM按Email查询返回Null问题求助

1. 修复CreateQueryBuilder的参数绑定错误 #

你第二个查询里的参数占位符和实际参数名不匹配：where('email = :emailParameter', { email }) 中，占位符是emailParameter，但参数对象的键是email，导致参数没有正确绑定，这必然查不到数据。

修正后的代码：

public async getUserByEmail(email: string): Promise<User | null> {
    let _res = await this._userRepository.createQueryBuilder("Users")
        .where("Users.Email = :email", { email })
        .andWhere("Users.IsActive = :isActive", { isActive: true })
        .getOne();
    return _res;
}

这里直接给QueryBuilder指定表别名Users，避免字段名和占位符冲突，同时补充了IsActive条件（和第一个查询逻辑对齐）。

2. 检查大小写敏感问题 #

SQL Server的nvarchar字段如果使用区分大小写的排序规则（比如SQL_Latin1_General_CP1_CS_AS），查询时邮箱的大小写必须和数据库存储的完全一致。

验证方法 #

直接在数据库执行SQL语句测试：

SELECT * FROM Users WHERE Email = '你的测试邮箱' AND IsActive = 1

如果这条SQL能查到数据，但代码查不到，说明是大小写不匹配。

解决方法 #

统一转成小写（或大写）后查询：

// 使用findOneBy的写法
public async getUserByEmail(email: string): Promise<User | null> {
    return this._userRepository.findOneBy({
        Email: email.toLowerCase(),
        IsActive: true
    });
}

// 或CreateQueryBuilder写法
public async getUserByEmail(email: string): Promise<User | null> {
    let _res = await this._userRepository.createQueryBuilder("Users")
        .where("LOWER(Users.Email) = LOWER(:email)", { email })
        .andWhere("Users.IsActive = :isActive", { isActive: true })
        .getOne();
    return _res;
}

3. 确认实体与数据库字段的映射一致性 #

检查数据库表的Email字段名是否和实体定义一致：

• 如果数据库里的字段是小写email，需要在实体的@Column装饰器中显式指定字段名：

@Column({ name: 'email', type: 'nvarchar', length: 100, unique: true })
Email: string;

4. 使用TypeORM推荐的查询方法 #

新版本TypeORM推荐使用findOneBy替代旧版findOne的参数写法，确保兼容性：

public async getUserByEmail(email: string): Promise<User | null> {
    return this._userRepository.findOneBy({
        Email: email,
        IsActive: true
    });
}

内容的提问来源于stack exchange，提问作者V. Benavides