使用Express-Handlebars渲染页面时出现TypeError: req.next is not a function错误的求助

看起来你遇到的问题主要来自几个配置和代码逻辑的小问题，我帮你一步步拆解解决：

1. 缺失path模块导入 #

你的代码里用了path.join(__dirname, "views")但没有导入path模块，先补上这行：

import path from 'path';

2. Express-Handlebars布局目录配置错误 #

通常layoutsDir是用来存放母版布局文件的目录（比如包含通用头部、尾部的模板），而不是页面文件所在的pages目录。假设你的视图目录结构是：

views/
  layouts/
    main.hbs  <!-- 主布局，必须包含{{{body}}}标记来插入页面内容 -->
  pages/
    login.hbs
  partials/
    <!-- 复用的小模板 -->

那你需要修正app.engine的配置：

app.engine("hbs", exphbs({ 
    extname: "hbs", 
    layoutsDir: path.join(__dirname, "/views/layouts/"), // 改为layouts目录
    partialsDir: path.join(__dirname, "/views/partials/"),
    defaultLayout: "main" // 指定默认使用的布局文件
}) );

如果你的login.hbs不需要使用布局，可以在渲染时显式指定：

res.render("login", { layout: false });

3. cookieAuth中间件未正确调用next() #

错误里的req.next is not a function很大概率是因为你的cookieAuth中间件没有遵循Express中间件规范——必须调用next()来传递请求，或者异步逻辑没有正确处理Promise。

确保你的cookieAuth是标准的中间件格式：

// 同步版本
export const cookieAuth = (req, res, next) => {
  try {
    // 这里写你的Cookie验证逻辑
    const userCookie = req.cookies.asmuser;
    req.asmuser = userCookie || null;
    next(); // 必须调用next，否则请求会卡住
  } catch (error) {
    next(error); // 把错误传递给Express的错误处理中间件
  }
};

// 如果是异步逻辑（比如查数据库验证）
export const cookieAuth = async (req, res, next) => {
  try {
    const user = await verifyYourCookie(req.cookies.asmuser);
    req.asmuser = user;
    next();
  } catch (error) {
    next(error);
  }
};

4. 根路由的redirect后未终止响应 #

在根路由里，res.redirect("/login")之后没有return，会导致代码继续执行，可能引发后续错误。修改成：

app.get("/", cookieAuth, (req: any, res) => { 
    if (req.asmuser == null) {
        return res.redirect("/login"); // 添加return终止响应
    }
    // 这里添加已认证用户的逻辑，比如渲染首页
    res.render("home");
});

5. 添加全局错误处理中间件 #

为了避免UnhandledPromiseRejection警告，建议添加Express的全局错误处理中间件，捕获所有未处理的错误：

app.use((err, req, res, next) => {
  console.error("服务器错误:", err.stack);
  res.status(500).send("服务器内部错误");
});

最后，记得检查login.hbs文件是否存在于正确路径（views/pages/login.hbs），如果使用了布局，布局文件里必须包含{{{body}}}标记，用来插入页面的核心内容。

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