Express如何正确配置嵌套路由？访问query/idn无init日志问题解决

最高概率的原因 #

你定义的所有路由全部为 POST方法接口，如果直接在浏览器地址栏输入地址访问，浏览器默认发送GET请求，完全匹配不到对应的POST路由，自然不会触发控制器里的console.log('init')。
测试接口时必须发送POST请求，不能用浏览器地址栏直接访问，可通过Apifox/Postman、前端fetch/axios等方式发起POST请求验证。

其他按出现概率排序的排查点 #

• 路由注册顺序不符合Express匹配规则
  Express的请求处理是严格按照代码从上到下的顺序执行的，一旦某个环节提前结束响应，后续的路由逻辑就不会执行。
  你需要确保app.use('/query', queryRouter)的位置满足：
• 放在404兜底路由、错误处理中间件之前
• 放在静态文件托管逻辑之前（避免静态资源提前拦截请求）
• 放在express.json()、express.urlencoded()等请求体解析中间件之后（这个不影响路由触发console.log，但会导致拿不到req.body的值）

正确的入口文件代码结构参考：

const express = require('express')
const app = express()
const PORT = 3001

// 1. 注册基础中间件
app.use(express.json())
app.use(express.urlencoded({ extended: true }))

// 2. 注册业务路由
const queryRouter = require('./routes/query')
app.use('/query', queryRouter)

// 3. 最后放置兜底逻辑
app.use((req, res) => res.status(404).send('接口不存在'))

app.listen(PORT, () => {
    console.log(`服务启动在${PORT}端口`)
})

• 文件路径/大小写不匹配
  Linux环境下文件路径是严格大小写敏感的：
• 检查require('./routes/query')的路径和实际文件位置完全一致，比如实际文件名为Query.js，require时写query.js会导致模块加载失败
• 检查路由路径的大小写，比如定义的是/idn，访问时写成/IDN会匹配失败
• 路由模块未正确导出
  检查路由文件最后是否存在module.exports = router，如果这行缺失，导入的router为undefined，注册的路由不会生效。

现有控制器的逻辑优化 #

就算路由通了，你当前的控制器代码存在响应重复发送的问题，会触发Express报错Can't set headers after they are sent：
在数据库查询的错误回调中，发送错误响应后没有终止后续逻辑执行，会继续走到成功发送的分支。比如：

// 原代码问题
accidentDetail.findOne({ idn: req.body.idn }, (err, data) => {
    if (err) {
        res.status(500).send(err)
        // 这里没有return，代码会继续往下执行
    }
    res.status(200).send(data)
})

修正方式：在发送错误响应前加return终止后续逻辑：

if (err) {
    // 加return，不再执行后续的成功响应逻辑
    return res.status(500).send(err)
}

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