Express配置Handlebars报Missing helper: generateDate.date问题咨询

错误原因 #

• 重复注册handlebars模板引擎，后续配置覆盖了前置的有效配置：代码前后三次调用app.engine("handlebars", ...)注册模板引擎，最后一次注册时没有传入helpers配置项，导致你定义的generateDate helper没有被最终生效的引擎加载。
• 混用了两种引擎注册方式逻辑冲突：同时使用exphbs.create()预生成配置实例和直接调用expressHandlebars()传入配置的两种注册方式，逻辑混乱导致配置丢失。
• 最后一次注册参数不符合规范：app.engine("handlebars", expressHandlebars({...}), exphbs());错误传入了第三个冗余参数，违反Express引擎注册的参数要求，进一步导致配置异常。
• 报错内容里的generateDate.date是Handlebars的解析逻辑导致：当找不到generateDate helper时，Handlebars会默认将generateDate识别为当前上下文的对象，尝试读取它的date属性，因此抛出该错误。

解决方法 #

删除所有冗余的引擎注册代码，全局只保留一套统一的配置即可，参考正确配置如下：

const Handlebars = require('handlebars')
const exphbs = require('express-handlebars')
const { allowInsecurePrototypeAccess } = require('@handlebars/allow-prototype-access')
const moment = require('moment')

// 统一完成所有hbs配置
const hbs = exphbs.create({
    handlebars: allowInsecurePrototypeAccess(Handlebars),
    helpers: {
        generateDate: (date, format) => {
            return moment(date).format(format)
        }
    }
})

// 仅注册一次模板引擎
app.engine('handlebars', hbs.engine)
app.set('view engine', 'handlebars')

原模板的调用代码{{generateDate date 'MMM DD YYYY'}}无需修改，配置修正后即可正常运行。

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