使用 mysql2/promise 模块返回以后，使用 await 返回数据总结
SELECT 返回结构
const [rows, fields] = await db.query('SELECT * FROM folders');
返回：
rows: 是一个数组，包含所有查到的记录。fields: 是字段的结构定义（列信息），一般不用。
rows 是一个数组，包含所有查到的记录：
[{ id: 1, name: '一级选项1', parent_id: null },{ id: 2, name: '子目录1', parent_id: 1 }
]
INSERT 返回结构
const [result] = await db.query('INSERT INTO folders (name, parent_id) VALUES (?, ?)', ['test', 1]);
result 是一个包含插入信息的对象：
{fieldCount: 0, // 字段数（一般是 0，插入不返回字段）affectedRows: 1, // 受影响的行数insertId: 17, // 新插入的主键 IDserverStatus: 2, // MySQL 服务器状态码warningCount: 0, // 警告数量，0 表示无警告message: '', // 服务器返回的信息，一般为空或插入成功消息protocol41: true, // 与协议有关，true 表示使用 4.1 协议changedRows: 0 // 插入时恒为 0，仅在 UPDATE 时有意义
}
所以判断成功的办法是通过 affectedRows：
if (result.affectedRows === 1) {return res.status(200).json({message: '目录添加成功',folderId: result.insertId});
} else {return res.status(500).json({ error: '添加目录失败' });
}
UPDATE 返回结构：
const [result] = await db.query('UPDATE folders SET name = ? WHERE id = ?', ['newName', 17]);
result 内容：
{fieldCount: 0,affectedRows: 1, // 匹配并执行更新的行数（包括实际没变内容的）insertId: 0, // 无插入则为 0serverStatus: 2,warningCount: 0,message: '(Rows matched: 1 Changed: 1 Warnings: 0)',protocol41: true,changedRows: 1 // 实际内容发生变化的行数
}
DELETE 返回结构：
const [result] = await db.query('DELETE FROM folders WHERE id = ?', [17]);
result 内容：
{fieldCount: 0,affectedRows: 1, // 删除成功的行数insertId: 0,serverStatus: 2,warningCount: 0,message: '', // 有时会包含删除说明protocol41: true,changedRows: 0 // 始终为 0，DELETE 不用这个字段
}
不能随便“模拟”结构解构，必须清楚它的真实结构是数组 [rows, fields]，否则会出错。
❌ 错误示例：
const { affectedRows } = await db.query(...); // ❌ 报错，因为它不是对象，是数组
✅ 正确示例：
const [result] = await db.query(...); // result 是对象
console.log(result.affectedRows); // 访问插入/更新结果
总结
| 场景 | 返回值结构 | 解构方式 |
|---|---|---|
| SELECT | [rows, fields] | [rows] 或 [rows, fields] |
| INSERT/UPDATE/DELETE | [result, undefined] | [result] |
由于
- 新增
result.affectedRows === 1； - 编辑
result.affectedRows > 0更新语句执行了，result.changedRows > 0内容确实有变更； - 删除
result.affectedRows > 0；
新增
const [result] = await db.query('INSERT INTO folders (name) VALUES (?)', ['Test']);if (result.affectedRows === 1) {console.log('插入成功，ID:', result.insertId);
} else {console.log('插入失败');
}
编辑
const [result] = await db.query('UPDATE folders SET name = ? WHERE id = ?', ['NewName', 5]);if (result.affectedRows > 0) {console.log('更新语句执行了');if (result.changedRows > 0) {console.log('内容确实有变更');} else {console.log('字段值没变（例如改成原来的值）');}
} else {console.log('没有任何记录被更新');
}
删除
const [result] = await db.query('DELETE FROM folders WHERE id = ?', [999]);if (result.affectedRows > 0) {console.log('删除成功');
} else {console.log('未删除任何记录（可能 id 不存在）');
}
最实用的判断逻辑：
try {const [result] = await db.query(sql, values);if (result.affectedRows > 0) {// ✅ SQL 生效} else {// ⚠️ SQL 没生效（可能条件不匹配）}
} catch (err) {// ❌ SQL 执行失败（语法、连接、权限等错误）
}