TypeORM QueryBuilder WHERE子句参数使用错误排查求助

看起来你遇到的是PostgreSQL（大概率是这个数据库）标识符大小写区分的问题，结合你的代码和报错信息，我来拆解下原因和解决方案：

问题根源 #

PostgreSQL会把未加双引号的标识符（表名、列名）自动转为小写，但你的数据库里实际列名是驼峰式的userId（包含大写字母）。在第一个QueryBuilder写法中，你写的something.userId被数据库解析成了something.userid，而这个列并不存在，所以报错。

而你用字符串拼接时手动加了双引号"something"."userId"，强制数据库识别驼峰格式的列名，所以能正常查询——但这种方式有SQL注入风险，不推荐长期使用。

解决方案 #

下面是几种安全且规范的解决方式：

1. 手动给列名添加双引号（参数化查询保持安全） #

在QueryBuilder的条件语句里，给表名和列名加上双引号，同时保持参数化传参的方式：

@EntityRepository(Something)
export class SomethingRepository extends Repository<Something>{
    findByUserAndSomethingById(userId: number, spotId: number){
        const thing = this.createQueryBuilder('something')
            // 给标识符加双引号，参数名改成userId避免混淆
            .where('"something"."userId" = :userId', { userId })
            .andWhere('"something"."id" = :spotId', { spotId })
            .getOne();
        return thing;
    }
}

这种方式直接适配数据库的列名格式，同时避免了SQL注入。

2. 开启TypeORM自动引号配置 #

在你的TypeORM数据源配置中，添加quoteIdentifiers: true选项，这样TypeORM会自动给所有表名、列名加上双引号，不用手动编写：

// 示例TypeORM配置（根据你的实际环境调整）
const dataSource = new DataSource({
    type: 'postgres',
    host: 'localhost',
    port: 5432,
    username: 'your_username',
    password: 'your_password',
    database: 'your_db',
    entities: [Something],
    quoteIdentifiers: true, // 开启自动引号
});

开启后，你最初的写法something.userId = :id会被自动转译为"something"."userId" = $1，既不用手动加引号，又保证了查询安全。

3. 检查实体类的列映射配置 #

确认你的Something实体类中，userId列的定义和数据库实际列名匹配：

@Entity()
export class Something {
    @PrimaryGeneratedColumn()
    id: number;

    // 如果数据库列是驼峰的userId，直接用@Column()即可
    @Column()
    userId: number;

    // 如果数据库列是下划线格式的user_id，需要显式指定name属性
    // @Column({ name: 'user_id' })
    // userId: number;
}

实体列名和数据库列名映射错误也会导致找不到列的问题，这一步可以帮你排除映射层面的问题。

重要提醒 #

一定要避免用字符串拼接的方式传递查询参数（比如${userId}），这种写法很容易被利用进行SQL注入攻击，参数化查询才是安全的标准做法。

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