访问Express已存在路由时仍返回自定义404页面问题求助

• 最常见的原因是全局404中间件的注册顺序错误：Express的路由、中间件执行顺序和代码书写顺序完全一致，如果404中间件定义在/google、/logout这些业务路由的前面，所有请求都会优先被404中间件拦截，不会走到后续的路由匹配逻辑。
• 路由拼写/配置错误：路由路径大小写、拼写和实际请求路径不匹配，或使用express.Router挂载路由时前缀配置错误，导致路由无法正常匹配。
• 前置中间件执行异常：比如passport初始化中间件没有正确注册，导致passport.authenticate执行异常提前终止，请求没有触发跳转逻辑，最终走到404中间件。
• 路由优先级冲突：存在前缀更高的通配路由优先匹配了请求，比如先定义了app.get('/:id', ...)，会把/google的google当做id参数匹配，导致后续的/google路由不生效。

1. 调整中间件注册顺序（90%以上该类问题的解决方案）

Express项目的中间件、路由注册必须遵循固定优先级顺序：

1. 内置基础中间件（express.json、express.urlencoded、express.static等）
2. 第三方中间件（passport.initialize、passport.session、session、cookie解析中间件等）
3. 所有业务路由（自定义接口、Router挂载逻辑）
4. 全局异常处理中间件
5. 全局404中间件

将你写的404中间件代码挪到所有路由定义的最后面即可，参考正确代码结构：

const express = require('express')
const app = express()
const session = require('express-session')
const passport = require('passport')

// 第一步：注册基础中间件
app.use(express.static('public'))
app.use(express.json())
app.use(session({/* 你的session配置 */}))
// 注册passport相关中间件
app.use(passport.initialize())
app.use(passport.session())

// 第二步：注册所有业务路由
app.get('/google', passport.authenticate('google', { scope: ['profile', 'email'] }));
app.get('/logout', (req, res) => {
    console.log(`\n`);
    console.log('\x1b[1m\x1b[31m', `*** User ${req.user.displayName} has logged out ***`);
    req.session = null;
    req.logout();
    res.redirect('/');
});
// 所有其他路由、Router挂载都放在该步骤

// 第三步：最后注册404中间件
app.use(function (req, res, next) {
  res.status(404).sendFile('public/404.html', {root: __dirname})
})

2. 路由匹配校验
   如果调整顺序后问题依然存在，可以在所有路由前添加临时调试中间件，确认请求的方法、路径和你定义的路由是否一致：

app.use((req, res, next) => {
  console.log(`请求方法：${req.method}，请求路径：${req.path}`)
  next()
})

3. 业务逻辑校验
   如果是谷歌登录路由异常，检查passport的谷歌策略是否正确配置，passport初始化中间件是否已经注册在路由之前；如果是通配路由冲突，将通配路由的定义放在精准路由的后面即可。

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