在使用 Node.js 的 mysql 模組操作資料庫時,開發者常會遇到一個問題:執行 UPDATE 或 DELETE 語句後,如何確認操作是否真正生效?在 MySQL 客戶端中,我們習慣緊跟著 SQL 語句呼叫 ROW_COUNT() 來獲取影響行數。但 Node.js 的 I/O 是非同步的,若在回呼函式中再查詢 ROW_COUNT(),根本無法確定它對應的是哪一條 SQL 語句的結果。
affectedRows翻閱官方文件雖未明確說明,但實測發現:db.query() 的回呼函式中,第二個參數 rows(實際上是 OkPacket 物件)包含 affectedRows 欄位,這正是我們需要的「影響行數」。
var cmd = 'UPDATE users SET ' + field + ' = ' + value + ' WHERE id = ' + userid;
console.log(cmd);
db.query(cmd, function(err, result, fields) {
var affectedRows = result.affectedRows;
if (err || affectedRows === 0) {
var msg = 'update ' + field + ' error';
logger.error(msg);
res.send({
'code': 500,
'state': 'failure',
'msg': msg,
'data': null
});
return;
}
res.send({
'code': 200,
'state': 'success',
'msg': 'updated',
'data': null
});
});
affectedRows 直接屬於當次查詢的回呼,天然避免了併發混淆。affectedRows === 0 表示沒有任何行被修改(WHERE 條件不匹配),視為業務失敗;> 0 才算成功。err 捕捉語法錯誤、連線中斷等異常,配合 affectedRows 雙重保險。同理,INSERT 操作可用 result.insertId 獲取自增 ID;批次操作時 affectedRows 為總影響行數。善用這些內建屬性,能讓資料庫操作的回饋更精準、程式碼更簡潔。