Express配置多视图目录触发ERR_INVALID_ARG_TYPE错误求助

问题原因 #

你碰到的TypeError [ERR_INVALID_ARG_TYPE]: The "from" argument must be of type string. Received an instance of Array错误，本质是你使用的express-handlebars版本未适配Express的多视图目录数组配置。

虽然Express 4.x开始支持用数组传递多个视图目录给app.set('views', [...])，但早期的express-handlebars版本内部依然把views参数当作字符串处理，在调用path.relative时传入了数组，直接触发了类型校验错误。

解决方案 #

下面提供三种可行的解决方式，按推荐优先级排序：

1. 升级express-handlebars到最新稳定版

这是最简单直接的方案，新版本已经完全适配Express的多视图目录特性：

npm uninstall express-handlebars && npm install express-handlebars

升级完成后，你原来的代码无需修改，就能正常读取两个目录下的模板文件。

2. 在express-handlebars实例中指定多视图目录

如果不想升级依赖，可以在初始化handlebars引擎时，直接通过views选项传入多个目录，替代app.set('views')的配置：

const hbs = require('express-handlebars');
const path = require('path');

// 初始化handlebars时配置多视图目录
const handlebarsEngine = hbs({
  defaultLayout: "main",
  views: [
    path.join(__dirname, 'views'),
    path.join(__dirname, 'public-views/zubizi-theme')
  ]
});

app.engine('handlebars', handlebarsEngine);
app.set('view engine', 'handlebars');
// 移除原来的app.set('views', [...])配置

这种方式让handlebars引擎自己管理视图目录，避开了Express传递数组的兼容性问题。

3. 自定义模板查找逻辑（不推荐）

如果上述两种方式都不适用，可以手动扩展视图查找逻辑，遍历所有视图目录寻找对应模板文件。不过这种方式需要修改引擎的内部查找逻辑，复杂度较高，仅适合特殊场景。

验证测试 #

配置完成后，你可以分别渲染两个目录下的模板来验证：

// 渲染views目录下的admin模板
app.get('/admin', (req, res) => {
  res.render('admin');
});

// 渲染public-views/zubizi-theme目录下的home模板
app.get('/', (req, res) => {
  res.render('home');
});

如果两个模板都能正常渲染，说明配置成功。

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