Hapi.js插件正确注册方法及注册失败报错求助

你踩了Hapi版本兼容的坑啦！这个错误的根源很明确——你使用的是Hapi v14.2.0，但安装的inert@5.0.1和vision@5.3.0是为Hapi v17及以上版本设计的。这些新版本插件的导出结构和Hapi v14预期的完全不一样，导致Hapi找不到插件的register方法，就抛出了这个错误。

两种解决方案任选其一 #

方案1：降级插件到兼容Hapi v14的版本 #

Hapi v14对应的Inert和Vision兼容版本是v3.x和v4.x，你只需要重新安装适配的旧版本即可：

npm uninstall inert vision
npm install inert@3.2.1 vision@4.1.1 --save

安装完成后再运行你的原代码，插件就能正常注册了。

方案2：升级Hapi到最新版本（更推荐） #

如果你的项目允许升级，建议直接把Hapi升到v17+，同时注意新版本的API变化：

1. 先更新依赖包：

npm uninstall hapi inert vision
npm install @hapi/hapi @hapi/inert @hapi/vision --save

2. 代码需要适配新版Hapi的Promise/async-await风格：

const Hapi = require('@hapi/hapi');

const init = async () => {
    const server = Hapi.server({
        port: 4004,
        host: 'localhost'
    });

    // 注册多个插件
    await server.register([require('@hapi/inert'), require('@hapi/vision')]);

    // 启动服务器
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// 捕获未处理的Promise拒绝
process.on('unhandledRejection', (err) => {
    console.error(err);
    process.exit(1);
});

init();

Hapi.js插件正确注册方法 #

针对Hapi v16及以下版本（比如你当前用的v14） #

1. 可以直接传入插件模块，或者传入包含register方法和name属性的配置对象
2. 注册单个/多个插件的示例：

var Hapi = require('hapi');
var server = new Hapi.Server();
server.connection({port: 4004});

// 注册单个插件
server.register(require('inert'), (err) => {
    if (err) throw err;
    server.start(() => console.log('Server started'));
});

// 注册多个插件，带配置项的写法
server.register([
    require('vision'),
    {
        register: require('some-other-plugin'),
        options: {
            // 这里写插件的配置参数
            foo: 'bar'
        }
    }
], (err) => {
    if (err) throw err;
    server.start(() => console.log('Server started'));
});

针对Hapi v17及以上版本 #

1. 新版Hapi全面使用Promise/async-await，不再依赖回调函数
2. 插件需要从@hapi/命名空间安装（比如@hapi/inert）
3. 注册示例：

const Hapi = require('@hapi/hapi');

const init = async () => {
    const server = Hapi.server({ port: 4004 });

    // 注册单个插件
    await server.register(require('@hapi/inert'));

    // 注册多个插件，部分带配置
    await server.register([
        require('@hapi/vision'),
        {
            plugin: require('another-plugin'),
            options: {
                enableFeature: true
            }
        }
    ]);

    await server.start();
    console.log('Server is running at:', server.info.uri);
};

init().catch(err => {
    console.error('Server failed to start:', err);
    process.exit(1);
});

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