Node.js实现无依赖文件下载时遇到ENOENT路径不存在报错求助
报错根因
- 抛出的
ENOENT错误本质是fs.createWriteStream()尝试打开目标文件时,路径包含的上级嵌套目录不存在 - Node.js 原生文件系统模块不会为写操作自动创建缺失的目录层级,只要目标路径中任意一级文件夹不存在,就会直接触发该异常
- 现有代码存在两个会放大问题的缺陷:
- 传入的
bot_side/img/image.jpg为相对路径,实际指向位置由Node.js进程的启动工作目录决定,而非当前代码文件所在目录,极易出现路径计算偏差 - 整个管道链路未添加错误捕获,一旦出现路径、网络类异常,会直接触发未处理的流错误导致进程崩溃,无有效排查提示
- 传入的
修复步骤
- 前置创建目标目录
拆分完整的文件保存路径,提取对应的目录层级,在创建写流之前,调用fs.mkdirSync()开启递归创建模式,一次性创建路径中所有缺失的文件夹,该操作不会覆盖已存在的目录。注意:递归创建参数为Node.js 10.12.0版本以上支持,若使用更低版本,需要手动逐层校验目录是否存在再创建。 - 替换全链路代码实现:
const fs = require('fs') const path = require('path') const request = require('request') // 基于当前代码文件位置拼接绝对路径,消除相对路径的计算偏差 const saveTargetPath = path.join(__dirname, 'bot_side', 'img', 'image.jpg') download(url, saveTargetPath, () => { return imageClassification(saveTargetPath) }) const download = (url, savePath, callback) => { // 从完整保存路径中拆分出目录部分 const targetDir = path.dirname(savePath) // 递归创建所有缺失的嵌套目录 fs.mkdirSync(targetDir, { recursive: true }) request.head(url, (err) => { if (err) throw new Error(`获取资源头信息失败: ${err.message}`) request(url) .pipe(fs.createWriteStream(savePath)) .on('close', callback) // 捕获全链路流错误,避免进程无提示崩溃 .on('error', (err) => { throw new Error(`文件写入失败: ${err.message}`) }) }) } - 路径校验技巧
修改后可在创建写流前添加一行console.log(path.resolve(savePath)),打印实际的文件写入绝对路径,手动核对是否和预期位置一致,排除路径拼写错误的问题
内容的提问来源于stack exchange,提问作者cyruslk
相关产品推荐
相关产品推荐

