TypeScript中访问数据库查询返回的UserBody类型对象属性为undefined问题

云上老周

2026-9-29

核心问题原因及解决方案

1. 误用类型断言，编译期校验不影响运行时结果

TypeScript的类型声明和断言仅在编译阶段做类型检查，不会改变运行时的实际返回数据结构。你将Promise<any>类型的返回值直接断言为UserBody[]，只是告诉编译器「你认为这个值符合这个结构」，但不会做任何运行时校验和转换，实际数据结构不对的话依然会取值失败。

2. ORM的query方法返回结构不符合预期

绝大多数关系型数据库对应的ORM（如TypeORM）的query方法，原始返回值是二元组结构：[查询结果行数组, 字段元数据信息]，你直接将整个返回值赋值为UserBody[]，相当于把二元组整体当成了用户数组，此时result[0]实际是所有查询行的集合，自然不存在empno这类用户属性，取值必然返回undefined。
解决方法：解构获取第一位的结果行数组：

// 解构拿到第一个元素，才是真正的查询结果行列表
const [result] = await getManager(body.store_code).query(query) as [UserBody[], any];

3. SQL查询返回字段与接口属性不匹配

如果数据库返回的字段名和你定义的UserBody属性名不一致（比如数据库字段为大写EMPNO、存储密码的字段名为pwd而非password），返回对象上不存在对应属性也会返回undefined。
解决方法：先打印原始返回值确认结构：

// 先打印完整的原始返回结果，确认结构和字段名
const rawResult = await getManager(body.store_code).query(query);
console.log('原始查询返回：', JSON.stringify(rawResult, null, 2));

如果字段名不匹配，修改SQL语句给字段加别名即可，比如：

SELECT emp_no as empno, user_pwd as password, name from user where xxx

4. 查询结果为空

如果SQL的查询条件没有命中任何数据，结果行数组本身为空，此时result[0]为undefined，访问它的属性也会返回undefined。需要增加非空判断：

const [result] = await getManager(body.store_code).query(query) as [UserBody[], any];
if (result.length > 0) {
  console.log(result[0].empno);
  // 执行密码对比逻辑
}

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