Express.js URL解析路径错误：如何正确映射本地站点文件？

你遇到的问题核心是路径构造错误加上res.sendFile的root参数使用不当，导致Express去系统根目录找文件，而不是你项目所在的e:\node.js目录。咱们一步步拆解问题，然后给出修正方案：

问题分析 #

你的原http代码里用了./site作为相对路径，这个路径是相对于server.js所在的e:\node.js目录的。但在Express尝试代码里：

1. 你把site设成了"/site"（以斜杠开头的绝对路径），导致拼接后的filename是/site/abc/123.html，这种绝对路径会让Express忽略root参数，直接从系统根目录（也就是e:\）开始查找，所以才会出现e:\site\abc.html的错误路径。
2. 同时使用fs.readFile和res.sendFile完全冗余，res.sendFile本身就会处理文件读取、Content-Type设置和错误处理，重复操作反而容易出问题。

修正方案 #

这里提供两种简洁的实现方式，选一种就行：

方式一：正确使用res.sendFile的root参数

利用Node.js的__dirname全局变量（它代表当前server.js文件所在的绝对路径），指定正确的站点根目录：

var express = require('express');
var app = express();
var port = 8080;

// __dirname就是e:\node.js，拼接后得到站点根目录e:\node.js\site
const siteRoot = __dirname + '/site';

app.get('*', function (req, res) {
  // 把请求路径加上.html后缀，比如请求/abc/123就变成/abc/123.html
  const filePath = req.url + '.html';
  
  // 这里filePath是相对于siteRoot的路径，res.sendFile会自动拼接成正确的绝对路径
  res.sendFile(filePath, { root: siteRoot }, function(err) {
    if (err) {
      console.error(err);
      res.status(404).send("404 Not Found");
    }
  });
});

var server = app.listen(port, function () {
  console.log('Running on port ' + port);
});

方式二：直接构造完整的绝对路径

如果你觉得root参数容易搞混，也可以直接用__dirname拼接出完整的文件路径，不需要root参数：

var express = require('express');
var app = express();
var port = 8080;

app.get('*', function (req, res) {
  // 直接拼接出完整的文件绝对路径：e:\node.js\site + 请求路径 + .html
  const fullFilePath = __dirname + '/site' + req.url + '.html';
  
  res.sendFile(fullFilePath, function(err) {
    if (err) {
      console.error(err);
      res.status(404).send("404 Not Found");
    }
  });
});

var server = app.listen(port, function () {
  console.log('Running on port ' + port);
});

额外注意点 #

• 不要再手动调用fs.readFile和res.writeHead了：res.sendFile会自动处理文件读取、设置正确的Content-Type（根据文件后缀）以及响应状态码，重复操作只会增加不必要的复杂度。
• 尽量用__dirname来构造绝对路径：避免相对路径在不同运行环境下出现解析错误的问题，这是Node.js项目里的最佳实践。

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