Node.js Express外部路由文件失效，请求返回404错误求助

嘿，我仔细看了你的代码和错误信息，马上就发现了两个核心问题，同时也给你整理一套易维护的路由管理最佳实践，帮你彻底解决问题！

一、当前404错误的直接原因 #

1. 路由代码未被加载

你的app.js里最后一行的路由引入代码被注释掉了：

// require('./config/router')(app);

这就导致你写的所有路由规则根本没被Express加载，自然所有请求都会走到后面的404中间件。

2. 中间件顺序错误

你把404错误处理中间件写在了路由加载之前，就算你取消注释路由代码，请求也会先触发404拦截——Express的中间件是按代码顺序依次执行的，错误处理中间件必须放在所有路由之后。

二、快速修复步骤 #

1. 修正app.js的代码顺序和路由引入

把路由加载代码取消注释，并调整中间件顺序，确保路由在404错误处理之前：

'use strict';
const createError = require('http-errors');
const express = require('express');
const path = require('path');
const cookieParser = require('cookie-parser');
const logger = require('morgan');
const bodyParser = require('body-parser');
const fs = require('fs');
const session = require('express-session');
const redis = require('redis');
const mongoose = require('mongoose');
const redisStore = require('connect-redis')(session);
const client = redis.createClient();
const app = express();
const _UTILS = require('./application/_UTILS');
const db = JSON.parse(fs.readFileSync('/srv/webkb_mean/config/configFiles/database.json', 'utf8'));

mongoose.connect('mongodb://' + db['mongodb']['url'] + '/webKB-main');
mongoose.Promise = global.Promise;

app.use(session({
  secret: _UTILS.getHashedValue(),
  store: new redisStore({ host: 'localhost', port: 6379, client: client, ttl: 36000 }),
  saveUninitialized: false,
  resave: false
}));

// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
app.engine('html', require('ejs').renderFile)

app.use(logger('dev'));
app.use(express.json());
app.use(express.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(bodyParser.urlencoded({ extended: true }))
app.use(bodyParser.json())
app.use(express.static(path.join(__dirname, 'views')));

// ✅ 先加载路由，再处理404
require('./config/router')(app);

// ✅ 404错误处理放在路由之后
app.use(function(req, res, next) {
  next(createError(404));
});

// ✅ 全局错误处理也放在最后
app.use(function(err, req, res, next) {
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};
  res.status(err.status || 500);
  res.render('error');
});

module.exports = app;

2. 确保路由文件的模块化写法正确

比如你的/routes/LOGIN/login.js应该用express.Router()来定义路由，而不是直接挂载到app上：

const express = require('express');
const router = express.Router();

// 处理GET /login请求
router.get('/', (req, res) => {
  res.render('login'); // 或者返回JSON等
});

// 处理POST /login请求
router.post('/', (req, res) => {
  // 登录逻辑处理
  res.send('登录请求已接收');
});

module.exports = router;

三、易维护的路由最佳实践 #

1. 目录结构规范

推荐你的路由目录结构如下，按功能模块拆分，清晰易维护：

webkb_mean/
├── app.js
├── config/
│   └── router.js          # 路由统一入口
├── routes/
│   ├── index.js           # 首页路由
│   └── auth/              # 认证模块（替代原LOGIN目录，更规范）
│       ├── login.js
│       ├── signin.js
│       └── forgotPassword.js
└── ...

2. 主路由入口优化

config/router.js可以进一步优化，按模块分组，更清晰：

module.exports = (app) => {
  // 首页模块
  app.use('/', require('./../routes/index'));
  
  // 认证模块：统一前缀/auth，减少重复路径
  const authRouter = require('./../routes/auth');
  app.use('/auth', authRouter);
  
  // 其他功能模块同理
  // app.use('/dashboard', require('./../routes/dashboard'));
};

如果想给认证模块统一加前缀，还可以在auth/index.js里再做一层挂载：

const express = require('express');
const router = express.Router();

router.use('/login', require('./login'));
router.use('/signin', require('./signin'));
router.use('/forgotpassword', require('./forgotPassword'));

module.exports = router;

3. 额外注意事项

• 检查路由文件的路径是否正确，避免../或./的路径错误导致模块加载失败
• 开发环境可以用console.log打印路由加载情况，确认路由是否被正确挂载
• 统一路由命名规范，比如用小写字母+短横线（/forgot-password），符合RESTful风格

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