pg-promise能否将查询结果映射为指定类型接口对象？

核心结论 #

pg-promise的TypeScript泛型仅做编译时类型约束，不会在运行时自动过滤数据库返回的额外字段——这不是操作错误，也不是库的功能缺失，而是TypeScript本身的特性决定的。

详细解释 #

1. 类型映射的本质
   你代码里的<User>泛型只是告诉TypeScript：“这个查询结果的结构应该匹配User接口”，但这只是编译阶段的类型检查，不会修改实际返回的数据。运行时数据库返回的所有列（比如id、email等未在接口中定义的字段）依然会存在于result对象中，只是TypeScript编辑器不会提示这些额外字段而已。

2. 如何得到仅含接口字段的结果

   • 最直接的方式：查询时明确指定需要的列，避免用select *，比如：

     const result = await db.oneOrNone<User>("select username, status FROM users where username = $1", "something");
     

     这样数据库本身就只返回你需要的字段，自然和接口完全匹配。
   • 若必须用select *，可以手动过滤字段：

     const rawResult = await db.oneOrNone("select * FROM users where username = $1", "something");
     const result: User | null = rawResult ? {
       username: rawResult.username,
       status: rawResult.status
     } : null;
     

   • 全局统一处理：可以利用pg-promise的result钩子或helpers工具，配置自动过滤逻辑，但这需要额外的全局配置，适合有统一需求的场景。

3. 仓库模式的影响
   不用仓库模式直接查询，对类型映射的行为没有任何影响。仓库模式只是一种代码组织方式，用来封装数据库操作逻辑，本质上和直接调用db.oneOrNone的类型处理逻辑完全一致，不会改变泛型的作用或运行时的数据结构。

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