Node.js使用express-fileupload移动文件到项目外目录报错如何解决

问题原因及解决方法 #

核心原因1：目标目录不存在，mv()方法无自动建目录能力 #

express-fileupload提供的mv()方法仅能移动文件到已存在的目录，不会自动创建不存在的层级目录。你项目内的public目录是初始化就存在的，所以写入正常，而项目外的destinationFolder如果未提前创建，就会抛出ENOENT错误。

核心原因2：相对路径基准不符合预期 #

path.resolve()传入相对路径时，基准是你启动Node进程的工作目录（cwd），如果你不是在myProject根目录下启动服务，相对路径的跳转结果就会和你预期不符。

核心原因3：路径拼接不规范 #

直接用字符串拼接路径在不同操作系统下可能出现分隔符不兼容问题，应该用path模块的方法拆分参数传入。

解决步骤 #

1. 提前创建目标目录：手动确认和myProject平级的destinationFolder目录真实存在，不存在则先手动创建。
2. 基于__dirname生成绝对路径：用当前文件的固定路径__dirname作为基准生成目标路径，避免工作目录变动导致的路径错误，示例如下：

// 假设当前代码文件位于 myProject/src/myFile/xxx.js
const targetDir = path.resolve(__dirname, '../../../destinationFolder');
const dir = path.join(targetDir, file.name);

如果代码写在myProject根目录的启动文件（比如app.js）中，写法如下：

const targetDir = path.resolve(__dirname, '../destinationFolder');
const dir = path.join(targetDir, file.name);

3. 自动创建目录（可选）：如果需要兼容目录不存在的场景，可以在调用mv()前先递归创建目标目录：

const fs = require('fs/promises');
// 递归创建目录，已存在时不会报错
await fs.mkdir(targetDir, { recursive: true });

file.mv(dir, function (err) {
  if (err) {
    console.log(err);
  } else {
    console.log("ok");
  }
});

内容的提问来源于stack exchange，提问作者Tollaris