Node.js查看页面源码时触发fs模块路径错误求助

嘿，我刚好碰到过类似的问题！你这个TypeError: path must be a string or Buffer错误，本质是传给fs.readFile的路径参数不符合要求，而且只在部分浏览器查看源码时触发，大概率是这些浏览器发起了一些你没考虑到的特殊请求（比如自动请求/favicon.ico、空路径，或者带奇怪编码的路径），你的代码没做校验就直接把路径丢给了fs模块。

可能的触发场景 #

• 部分浏览器会在页面加载时自动请求/favicon.ico，如果你的项目里没有这个文件，或者路径处理逻辑没过滤这种请求，就可能导致路径解析异常。
• 查看源码时，某些浏览器会发起重复请求，或者请求路径带特殊参数，你的路径处理逻辑没做类型校验，传入了非字符串类型的值。

具体修复方案 #

1. 先给路径加类型校验

在调用fs.readFile之前，先判断路径的类型，不符合要求直接返回404，避免触发错误：

const fs = require('fs');
const http = require('http');

http.createServer((req, res) => {
  // 这里是你原本的路径处理逻辑，比如从req.url转换
  let filePath = /* 你的路径处理代码 */;

  // 关键：先校验路径类型
  if (typeof filePath !== 'string' && !Buffer.isBuffer(filePath)) {
    res.writeHead(404, {'Content-Type': 'text/plain'});
    res.end('404 Not Found');
    return;
  }

  // 再执行文件读取
  fs.readFile(filePath, (err, data) => {
    if (err) {
      res.writeHead(404);
      res.end(`File not found: ${filePath}`);
      return;
    }
    // 正常响应逻辑
    res.writeHead(200);
    res.end(data);
  });
}).listen(3000);

2. 过滤浏览器自动发起的特殊请求

比如直接拦截/favicon.ico请求，返回204告诉浏览器不用再请求：

if (req.url === '/favicon.ico') {
  res.writeHead(204); // 204代表无内容，浏览器不会继续重试
  res.end();
  return;
}

3. 用path模块标准化路径，避免异常

借助Node.js的path模块来处理路径，既能避免相对路径问题，还能防止路径遍历攻击：

const path = require('path');
// 假设你的静态文件都放在public目录下
const rootDir = path.join(__dirname, 'public');
// 标准化请求路径
let filePath = path.join(rootDir, req.url);

// 额外校验：确保路径在允许的目录范围内，防止恶意路径遍历
if (!filePath.startsWith(rootDir)) {
  res.writeHead(403);
  res.end('Forbidden');
  return;
}

调试小技巧 #

你可以在fs.readFile之前加一行日志，打印每次请求的路径和类型，这样就能精准定位到是哪个请求搞的鬼：

console.log(`请求URL: ${req.url}, 处理后路径: ${filePath}, 路径类型: ${typeof filePath}`);

运行服务器后，触发错误时看控制台日志，就能知道具体是哪个路径出了问题，针对性修复就行。

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