NestJS注册@fastify/cookie插件出现类型不兼容错误求助

问题原因 #

你遇到的类型不兼容错误，核心是版本匹配冲突和ES模块导出的类型适配问题：

• @nestjs/platform-fastify@9.2.0 与 @fastify/cookie@8.3.0 的类型定义不兼容，后者是为更高版本的Fastify框架设计；
• @fastify/cookie v8的ES模块默认导出类型，与NestJS Fastify应用的register方法类型期望不匹配。

解决方案 #

方案1：降级@fastify/cookie到兼容版本 #

将@fastify/cookie调整为与@nestjs/platform-fastify@9.x兼容的版本：

npm install @fastify/cookie@^7.0.0
# 或使用yarn
yarn add @fastify/cookie@^7.0.0

降级后原注册代码可直接正常运行。

方案2：通过FastifyAdapter实例注册插件（适配v8版本） #

如果不想降级，可绕过NestJS应用层的类型校验，直接在FastifyAdapter实例上注册插件：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';
import fastifyCookie from '@fastify/cookie';

async function bootstrap() {
  const adapter = new FastifyAdapter();
  // 先在adapter实例上注册cookie插件
  await adapter.register(fastifyCookie, { secret: '你的密钥' });
  
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    adapter,
  );

  await app.listen(3005);
}

bootstrap();

方案3：调整导入方式适配ES模块导出 #

部分场景下，通过全量导入并指定默认导出，可解决类型不匹配问题：

import * as fastifyCookie from '@fastify/cookie';

// 注册时使用默认导出
await app.register(fastifyCookie.default, { secret: '你的密钥' });

验证 #

修改后启动项目，若类型错误消失，且cookie功能（设置/读取）正常，则问题解决。

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