Express通配符路由覆盖其他路由问题排查

核心原因 #

Express的路由匹配是按注册顺序优先级执行的——先注册的路由会先匹配请求，一旦匹配成功就不会再往后执行。你的问题出在动态导入路由的异步特性：

• import()是异步操作，如果你没有等待所有路由文件导入并注册完成，就同步注册了app.all('*')兜底路由，会导致兜底路由先被加载到Express的路由栈中。
• 哪怕你把兜底路由代码写在路由注册逻辑的后面，只要路由注册是异步且没加await，JavaScript会先执行同步的兜底路由注册，再处理异步的路由导入，最终兜底路由的注册顺序还是早于业务路由，自然会覆盖所有请求。

解决方案 #

要确保所有业务路由都在兜底路由之前完成注册，必须将路由注册逻辑包装成异步操作并等待完成，再注册兜底路由：

示例代码（server.ts）

import express from 'express';
import fs from 'fs/promises';
import path from 'path';

const app = express();

// 读取routes文件夹下所有路由文件
async function getRouteFiles() {
  const routesDir = path.join(__dirname, 'routes');
  const files = await fs.readdir(routesDir);
  // 过滤出.ts文件（排除.d.ts声明文件）
  return files.filter(file => file.endsWith('.ts') && !file.endsWith('.d.ts'));
}

// 批量注册路由
async function registerAllRoutes() {
  const routeFiles = await getRouteFiles();
  
  // 用Promise.all并行导入所有路由模块并注册
  await Promise.all(routeFiles.map(async (file) => {
    const { router } = await import(`./routes/${file}`);
    // 假设每个路由模块导出的是express.Router实例
    app.use(router);
  }));
}

// 启动服务器的主逻辑
async function startServer() {
  // 先等待所有业务路由注册完成
  await registerAllRoutes();

  // 最后注册404兜底路由
  app.all('*', (req, res) => {
    res.status(404).json({ code: 404, message: '接口不存在' });
  });

  app.listen(3000, () => {
    console.log('服务器运行在 http://localhost:3000');
  });
}

// 执行启动逻辑并捕获错误
startServer().catch(err => {
  console.error('服务器启动失败:', err);
  process.exit(1);
});

额外检查点 #

1. 确认路由文件中的定义正确：每个路由文件应该导出express.Router()实例，例如：

// routes/users.ts
import express from 'express';
export const router = express.Router();

router.get('/users', (req, res) => {
  res.json({ data: [] });
});

2. 避免在业务路由中使用*通配符路径，否则会提前匹配所有请求，导致兜底路由无法触发。

内容的提问来源于stack exchange，提问作者shestakov-dev