Sequelize TypeScript报错：Property '[Op.and]'不存在于WhereAttributeHash<any>

问题说明 #

使用Sequelize动态构建WHERE子句时，在WhereOptions中使用[Op.and]触发TypeScript类型错误：

Property '[Op.and]' does not exist on type 'WhereAttributeHash'

核心原因 #

WhereOptions类型包含两个分支：WhereAttributeHash（普通属性匹配哈希）和WhereLogicalOptions（逻辑操作符结构）。直接声明WhereOptions时，TypeScript会优先推断为WhereAttributeHash类型，该类型不包含Op.and这类逻辑操作符字段，因此触发类型不匹配。

严格类型安全的解决方案 #

方案一：显式关联模型类型 #

通过WhereOptions<Person>（Person为你的模型类型）明确指定类型，让TypeScript识别逻辑操作符的合法性：

import { Op, WhereOptions } from 'sequelize';
import { Person } from './models'; // 导入你的Person模型

interface PersonFilters {
    firstName?: string;
    lastName?: string;
    age?: string;
}

export const getPerson = async (filters: PersonFilters): Promise<Person[]> => {
    // 关联Person模型的类型，明确支持逻辑操作符
    const whereOptions: WhereOptions<Person> = {
        [Op.and]: []
    };

    if (filters.firstName) {
        whereOptions[Op.and]?.push({ firstName: filters.firstName });
    }

    if (filters.lastName) {
        whereOptions[Op.and]?.push({ lastName: filters.lastName });
    }

    if (filters.age) {
        // 注意：如果age是数字类型，需转换类型（根据模型定义调整）
        whereOptions[Op.and]?.push({ age: parseInt(filters.age, 10) });
    }

    // 处理空条件：避免生成无效的AND子句
    if (whereOptions[Op.and]?.length === 0) {
        delete whereOptions[Op.and];
    }

    return await Person.findAll({
        where: whereOptions
    });
}

方案二：先收集条件再组装 #

先构建条件数组，最后统一生成包含Op.and的WhereOptions，避免直接操作属性导致类型问题：

import { Op, WhereOptions } from 'sequelize';
import { Person } from './models';

interface PersonFilters {
    firstName?: string;
    lastName?: string;
    age?: string;
}

export const getPerson = async (filters: PersonFilters): Promise<Person[]> => {
    const conditions: WhereOptions<Person>[] = [];

    if (filters.firstName) {
        conditions.push({ firstName: filters.firstName });
    }

    if (filters.lastName) {
        conditions.push({ lastName: filters.lastName });
    }

    if (filters.age) {
        conditions.push({ age: parseInt(filters.age, 10) });
    }

    // 根据条件数组是否为空，动态生成WhereOptions
    const whereOptions: WhereOptions<Person> = conditions.length > 0 
        ? { [Op.and]: conditions } 
        : {};

    return await Person.findAll({
        where: whereOptions
    });
}

方案三：类型断言（谨慎使用） #

如果上述方案不适用，可通过类型断言强制指定结构，但会降低部分类型安全性，仅在确定结构正确时使用：

const whereOptions: WhereOptions = {
    [Op.and]: []
} as WhereOptions & { [Op.and]: WhereOptions<Person>[] };

关键注意事项 #

• 始终关联具体模型类型（WhereOptions<Person>），而非WhereOptions<any>，确保TypeScript检查条件属性的合法性。
• 必须处理空条件数组：若所有过滤器都为空，Op.and的空数组会生成无效SQL，需判断后删除该属性或赋值为空对象。

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