Fastify 5.1.0 TypeScript泛型示例编译错误求助

问题根源 #

你定义的IReply接口明确了各状态码对应的返回结构：

interface IReply {
  200: { success: boolean };
  302: { url: string };
  '4xx': { error: string };
}

但/auth路由的handler直接返回了字符串logged in!，这和IReply中200状态码要求的{ success: boolean }类型完全不匹配，触发TypeScript类型校验错误。Fastify 5.x的类型系统会强制要求路由返回值与Reply泛型定义的结构严格对齐。

两种解决思路 #

思路1：修改IReply适配返回值 #

如果你确实需要返回字符串，调整IReply中200状态码对应的类型为string：

interface IReply {
  200: string; // 改为字符串类型
  302: { url: string };
  '4xx': { error: string };
}

此时handler返回logged in!就符合类型要求了。

思路2：修改handler返回值适配IReply #

如果要保留原IReply的结构，调整handler返回值匹配200状态码的定义：

async (request, reply) => {
  const customerHeader = request.headers['h-Custom']
  // 返回符合IReply.200的结构
  return { success: true }
  // 或者显式指定状态码并发送
  // reply.status(200).send({ success: true })
}

额外注意 #

Fastify 5.x对类型校验的严格度比旧版本更高，官方文档示例是针对特定场景的演示，实际使用时必须保证路由返回值与Reply泛型的状态码-返回体映射完全一致。

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