Node.js文件上传报错：oldPath参数为undefined问题排查

报错提示oldPath为undefined，核心原因是你使用的formidable v3+版本与W3Schools教程依赖的旧版（v2及以下）API不兼容：

• 新版formidable中，files对象里的文件字段默认是数组（支持多文件上传），而非单个对象
• 文件临时路径的属性名从filepath改为了path

方案1：适配新版formidable（推荐） #

修改代码中获取文件信息的部分，调整为新版API，同时增加错误处理避免程序崩溃：

var http = require("http");
var formidable = require("formidable");
var fs = require("fs");
http
  .createServer(function (req, res) {
    if (req.url == "/fileupload") {
      var form = new formidable.IncomingForm();
      form.parse(req, function (err, fields, files) {
        // 处理解析错误
        if (err) {
          res.writeHead(500, {"Content-Type": "text/plain"});
          res.write("文件解析错误: " + err.message);
          return res.end();
        }
        // 取第一个上传的文件（单文件场景）
        const file = files.filetoupload?.[0];
        if (!file) {
          res.writeHead(400, {"Content-Type": "text/plain"});
          res.write("未选择文件");
          return res.end();
        }
        var oldpath = file.path;
        var newpath = "C:/Users/sahin/" + file.originalFilename;
        fs.rename(oldpath, newpath, function (err) {
          if (err) {
            res.writeHead(500, {"Content-Type": "text/plain"});
            res.write("文件移动失败: " + err.message);
            return res.end();
          }
          res.write("File uploaded and moved!");
          res.end();
        });
      });
    } else {
      res.writeHead(200, {"Content-Type": "text/html"});
      res.write(
        '<form action="fileupload" method="post" enctype="multipart/form-data">'
      );
      res.write('<input type="file" name="filetoupload"><br>');
      res.write('<input type="submit">');
      res.write("</form>");
      return res.end();
    }
  })
  .listen(8080);

方案2：降级到旧版formidable #

如果你想完全沿用教程的写法，可以安装v2.x版本的formidable：

npm uninstall formidable
npm install formidable@2.1.2

• 确保目标路径C:/Users/sahin/存在且有写入权限，否则fs.rename会触发权限错误
• 日常开发中建议始终在异步操作中加入错误处理，避免小问题导致整个服务崩溃

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