Express发送Pug文件时单个端点无响应无报错问题排查求助

核心问题定位思路 #

你遇到的无报错无响应问题绝大多数是异步错误未被捕获导致的请求挂起，可按以下优先级排查：

1. 优先检查res.locals.guilds是否存在 #

你的validateGuild中间件直接调用res.locals.guilds.find，如果前置中间件没有给res.locals挂载guilds字段（比如你忘记在之前的鉴权中间件里把用户所属服务器列表赋值到这里），会直接抛出TypeError: Cannot read property 'find' of undefined，但因为中间件是async函数且没有错误捕获逻辑，错误会被吞掉导致请求无响应。

可先在validateGuild开头加日志验证：

module.exports.validateGuild = async (req, res, next) => {
  try {
    // 新增日志验证字段是否存在
    console.log('res.locals.guilds 值：', res.locals.guilds)
    res.locals.guild = res.locals.guilds.find(g => g.id === req.params.id);
    return res.locals.guild ? next() : res.render('errors/404');
  } catch (err) {
    // 打印错误
    console.error('validateGuild 报错：', err)
    next(err)
  }
};

2. 修复Mongoose模型对象默认值的错误 #

你当前给general字段设置的默认值是直接实例化的GeneralModule对象，这是Mongoose的经典坑：对象类型的默认值如果直接传静态对象，所有文档会共享同一个引用实例，轻则导致数据异常，重则触发保存校验失败。

修改models/guild.js的默认值配置，改成函数返回新实例：

module.exports = model('guild', {
  _id: String,
  general: { 
    type: Object, 
    // 改成函数返回，每次新建文档都会生成独立的实例
    default: () => new GeneralModule() 
  }
});

3. 给所有异步逻辑加错误捕获 #

Express原生不会自动捕获async路由/中间件抛出的错误，必须手动加try/catch或者用错误处理包裹函数，才能把错误打印出来。

给路由处理函数加捕获逻辑：

router.get('/servers/:id', validateGuild,
  async (req, res, next) => {
    try {
      const savedGuild = await guilds.get(req.params.id);
      // 打印日志确认返回值
      console.log('查询到的savedGuild：', savedGuild)
      res.render('dashboard/show', {
        savedGuild,
        subtitle: `- Dashboard`
      });
    } catch (err) {
      console.error('路由处理报错：', err)
      next(err)
    }
});

给guilds.get方法加捕获逻辑：

async get(id) {
  try {
    console.log('查询guild的id：', id)
    const exist = await SavedGuild.findById(id);
    if(exist) {
      console.log('查到已存在的guild：', exist)
      return exist
    }
    const newGuild = await new SavedGuild({ _id: id }).save();
    console.log('新建并保存的guild：', newGuild)
    return newGuild
  } catch (err) {
    console.error('guilds.get 报错：', err)
    throw err
  }
}

4. 新增全局错误处理中间件 #

在你的Express入口文件所有路由之后，加全局错误处理中间件，确保所有未捕获的错误都会被打印：

app.use((err, req, res, next) => {
  console.error('全局捕获错误：', err)
  res.status(500).render('errors/500')
})

按以上步骤操作后，控制台会打印出具体的错误信息，就能直接定位根因。

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