萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 常見錯誤排查手冊:EBADF、maxBuffer 超限、Pomelo RPC 失敗實戰解析

錯誤一:Error: EBADF, write / close / bad file descriptor

含義

EBADF = Bad file descriptor。嘗試對已關閉、無效或錯誤類型的文件描述符進行讀寫/關閉操作。

典型場景 1:寫入已關閉的 fd

const fd = fs.openSync(path, 'w');
emitter.on('data', data => fs.write(fd, data)); // 異步寫入
// 某處提前關閉
setTimeout(() => fs.closeSync(fd), 10);
// 但 emitter 仍在觸發 data 事件 → EBADF, write

解決

  • 確保關閉 fd 後不再有寫入操作:移除監聽器、設置標誌位、或在 `close` 事件中清理。
  • 使用 `fs.createWriteStream` 替代底層 fd,流自動管理生命周期。

場景 2:重複關閉 fd

emitter.on('end', () => {
    fs.closeSync(fd);
    fs.closeSync(fd); // 第二次調用 → EBADF, close
});

解決

  • 設置標誌位 `let closed = false; if (!closed) { fs.closeSync(fd); closed = true; }`
  • 或 `try { fs.closeSync(fd) } catch (e) { if (e.code !== 'EBADF') throw e; }` 忽略重複關閉錯誤。

場景 3:讀取已關閉 fd

錯誤信息更友好,會顯示調用棧,直接定位代碼修復。

錯誤二:Error: stdout maxBuffer exceeded

原因

`child_process.exec/execFile/spawnSync/execSync` 默認 `maxBuffer: 200KB`,子進程輸出超過此限制即拋錯。

解決方案

const { exec } = require('child_process');
exec('big-command', {
    encoding: 'utf8',
    maxBuffer: 10 * 1024 * 1024, // 10MB
    timeout: 0,
    killSignal: 'SIGTERM'
}, (err, stdout, stderr) => { ... });

// 或使用流式處理,避免緩衝
const { spawn } = require('child_process');
const child = spawn('big-command');
let output = '';
child.stdout.on('data', chunk => output += chunk);
child.on('close', code => { console.log(output); });

錯誤三:Pomelo "Cannot call method 'forwardMessage' of undefined"

現象

前端連接器轉發消息到後端服務器失敗,RPC 調用鏈中找不到目標服務器實例。

根因排查

  • `servers.json` 中普通遊戲服務器誤配置 `"frontend": true`,導致其被註冊為前端服務器,消息路由錯亂。
  • Handler 路由配置錯誤(`route` 映射不匹配)。
  • 後端服務器未啟動或註冊失敗(檢查 Zookeeper/Consul 註冊中心)。

修復

// servers.json 正確示例
{
  "connector": [{ "id": "connector-1", "host": "127.0.0.1", "port": 3050, "frontend": true }],
  "game": [{ "id": "game-1", "host": "127.0.0.1", "port": 3051, "frontend": false }] // 必須為 false
}

通用調試技巧

  1. 啟用 `NODE_DEBUG=fs,net,http` 獲取核心模塊詳細日誌。
  2. 使用 `node --inspect` + Chrome DevTools 斷點調試異步堆棧。
  3. 所有異步回調務必處理錯誤:`fs.readFile(..., (err, data) => { if (err) return handleError(err); ... })`。
  4. 文件操作優先使用 Promise 版 API (`fs.promises`),配合 `try/catch` 統一錯誤處理。
copyright © 萬盛學電腦網 all rights reserved