原生Node.js搭建Web服务时静态文件路由用大量if else是否正常及优化方案

1. 现有实现是否属于常规做法 #

这种逐行编写else if硬匹配路由的方式仅适用于功能极简的Demo测试项目，完全不属于生产环境的常规实现方案。它的缺陷非常明显：新增资源就要修改服务代码，逻辑重复度高，维护成本会随着页面规模增长指数级上升。 #

2. 原生Node.js优化方案 #

仅用原生Node.js完全可以解决该问题，核心思路是将请求路径与本地静态资源目录做自动映射，不需要手动逐条匹配路由，具体实现需要注意几个核心点：

• 统一设置静态资源根目录（例如命名为public，所有html、css、图片等对外提供的资源都放在该目录下）
• 自动根据req.url拼接本地文件路径，同时做路径安全校验，避免攻击者通过../遍历到静态目录外的敏感文件
• 配置通用的文件后缀与MIME类型映射，不需要硬写响应头
• 统一封装404、文件读取错误的处理逻辑

参考实现代码如下：

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

// 静态资源根目录配置
const STATIC_ROOT = path.join(__dirname, 'public');
// 常见文件MIME类型映射，可按需扩展
const MIME_TYPES = {
  '.html': 'text/html',
  '.css': 'text/css',
  '.js': 'text/javascript',
  '.png': 'image/png',
  '.jpg': 'image/jpeg',
  '.gif': 'image/gif'
};

const server = http.createServer((req, res) => {
  // 根路径默认跳转至首页
  if (req.url === '/') {
    res.writeHead(307, { 'Location': '/index.html' });
    return res.end();
  }

  // 拼接本地文件路径，自动处理路径格式
  const filePath = path.join(STATIC_ROOT, req.url);
  // 安全校验：禁止访问静态根目录之外的文件
  if (!filePath.startsWith(STATIC_ROOT)) {
    res.writeHead(403, { 'Content-Type': 'text/html' });
    return res.end('<p>Forbidden</p>');
  }

  // 自动匹配响应内容类型
  const ext = path.extname(filePath).toLowerCase();
  const contentType = MIME_TYPES[ext] || 'application/octet-stream';

  // 统一读取文件返回
  fs.readFile(filePath, (err, data) => {
    if (err) {
      res.writeHead(404, { 'Content-Type': 'text/html' });
      return res.end('<p>File not found</p>');
    }
    res.writeHead(200, { 'Content-Type': contentType });
    res.end(data);
  });
});

server.listen(3000);

使用该方案后，新增页面只需要把对应html文件放入public目录即可，不需要修改服务代码。 #

3. 生产环境推荐方案 #

如果项目复杂度较高，不需要手动造轮子，直接使用成熟的社区方案即可：

• 基于Express框架开发的项目，直接使用内置的express.static中间件，一行代码即可完成静态服务配置，自动处理缓存、MIME匹配、跨域等常见需求
• 基于Koa框架开发的项目，可以使用koa-static中间件，功能完善配置简单
• 如果是纯静态站点部署，也可以直接使用Nginx、Caddy等专业Web服务器提供静态服务，性能远高于Node.js实现，还自带压缩、缓存规则配置、HTTPS一键开通等能力

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