NestJS Fastify中FastifyHelmet与FastifyPlugin类型不兼容问题

1. 确认导入方式正确 #

@fastify/helmet v11采用默认导出，确保导入代码为：

import helmet from '@fastify/helmet';

避免使用命名导入（如import { helmet } from '@fastify/helmet'），这会直接导致类型匹配失败。

2. 调整依赖版本匹配 #

@fastify/helmet v11对Fastify类型定义做了更新，当前@nestjs/platform-fastify v10.3.3可能未完全适配该版本。可尝试降级@fastify/helmet到v10.x系列：

npm install @fastify/helmet@10.1.1

该版本与NestJS v10的Fastify适配器类型兼容性更稳定。

3. 类型断言绕过类型检查（临时方案） #

若不想降级依赖，可在注册插件时添加类型断言强制匹配类型：

await app.register(helmet as unknown as import('fastify').FastifyPluginCallback);

或使用更简洁的断言：

await app.register(helmet as any);

4. 排查重复依赖冲突 #

运行以下命令检查Fastify相关依赖版本是否一致：

npm ls fastify

若存在多个版本的fastify或其类型定义，需清理重复依赖，确保所有Fastify相关包依赖同一主版本。

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