本地运行正常EC2执行Node.js生成的脚本报Shell file busy异常
EC2环境执行shell脚本报「Shell file busy」修复指南
核心报错本质
触发的「Shell file busy」对应系统层面的
ETXTBSY错误,内核会在待执行文件被进程持有可写文件描述符、未完成写入刷盘的状态下,直接拒绝执行该文件——核心目的是避免加载半写入状态的损坏可执行文件。
本地运行无问题、EC2部署后报错的差异来源非常明确:本地SSD IO延迟极低,靠3秒的定时器刚好覆盖“文件打开-写入-刷盘-句柄释放”的全流程;EC2上不管是EBS云盘还是网络挂载存储,IO调度逻辑、刷盘延迟和本地环境不一致,3秒的超时逻辑根本碰不到“可安全执行”的状态,自然会触发报错。
现存代码的几个关键问题
- 没有正确处理文件描述符的生命周期:通过
fs.open拿到文件描述符desc后,写入操作完成后从未主动调用fs.close释放句柄,Node进程会一直持有该文件的写权限标记,内核自然判定文件“正被写入、不可执行”。 - 靠
setTimeout卡3秒等写入完成的逻辑完全不可靠:EC2上IO延迟波动极大,3秒可能还没完成文件落盘,根本不适合作为执行脚本的触发条件。 - 路径不匹配的隐患:写文件用的是
${baseDir}/result.sh绝对路径,但执行脚本时用的是./result.sh相对路径,EC2上Node进程的工作目录和本地完全不同,极易出现路径错位、找错文件的问题。 - 之前尝试的
fs.unlink没生效的原因:没有先释放旧的文件句柄就直接删除重建文件,旧文件节点依然被进程持有写标记,新创建的文件写入过程同样会触发busy报错。
可落地的修复方案
- 打通文件操作的完整异步链路,完全废弃定时器碰运气的逻辑:打开文件→写入内容→收到写入成功回调→显式关闭文件描述符→所有操作完成后再执行shell脚本,彻底保证文件状态稳定可执行。
- 统一使用绝对路径操作文件和执行脚本,消除路径错位的隐患。
- 不要依赖定时器做流程衔接,所有步骤严格按回调顺序触发,从根源上避免竞态条件。
修正后的参考代码
const { exec } = require('child_process'); const fs = require('fs'); const moment = require('moment'); const path = require('path'); let baseDir = "/Users/tarekhabche/Desktop/awsTest"; // 部署到EC2时替换为服务器上的实际绝对路径 const today = moment(new Date()).format("YYYY-MM-DDTHH:mm:ss"); const shellScriptPath = path.join(baseDir, "result.sh"); // 1. 先确保旧文件被清理,且没有被进程持有句柄 fs.rm(shellScriptPath, { force: true }, (rmErr) => { if (rmErr) throw rmErr; // 2. 创建新文件,设置可执行权限 fs.open(shellScriptPath, "wx", 0o777, (openErr, desc) => { if (openErr) throw openErr; const scriptContent = `mongoexport --db=graphqlAmazonV4 --collection=purchasefromappobjectmodels --type=csv --fields=purchaseDate,idfa,status --query '{"purchaseDate": { "$gte" : { "$date" : "${startDate}"} , "$lte" : { "$date" : "${endDate}"}}}' --out=results/result."${today}".csv`; // 3. 写入脚本内容 fs.write(desc, scriptContent, (writeErr) => { if (writeErr) { fs.closeSync(desc); // 写入失败也要释放句柄 throw writeErr; } // 4. 写入完成后,显式关闭文件描述符,彻底释放句柄 fs.close(desc, (closeErr) => { if (closeErr) throw closeErr; // 5. 所有文件操作完成,文件状态稳定后再执行脚本 exec(shellScriptPath, (execErr, stdout, stderr) => { if (execErr) throw execErr; console.log(stdout); console.log(stderr); }); }); }); }); });
额外注意事项
- EC2上如果挂载的是NFS等网络文件系统,要确保服务进程对挂载目录有正确的读写、执行权限,避免因为权限问题叠加触发文件busy的异常。
- 完全不要使用
setTimeout来衔接文件写入和脚本执行的流程,这类无明确触发条件的等待逻辑,在不同环境下的表现差异极大,是这类跨环境bug的核心来源。
内容的提问来源于stack exchange,提问作者tarek habche
相关产品推荐
相关产品推荐

