Fastify的json-schema-to-ts类型提供器无法正常工作

1. 检查依赖版本兼容性 #

Fastify的JSON Schema类型推断依赖@fastify/type-provider-json-schema-to-ts和json-schema-to-ts，必须保证它们与Fastify主包版本匹配：

• 确认package.json中fastify版本≥4.0.0
• 升级@fastify/type-provider-json-schema-to-ts和json-schema-to-ts至最新兼容版本
• 执行npm install或yarn install重新安装依赖，清除缓存

2. 修正类型提供者的初始化方式 #

必须在Fastify实例初始化时明确绑定类型提供者，否则类型推断会失效：

import Fastify from 'fastify';
import { JsonSchemaToTsProvider } from '@fastify/type-provider-json-schema-to-ts';

// 关键步骤：绑定类型提供者
const fastify = Fastify().withTypeProvider<JsonSchemaToTsProvider>();

fastify.get('/test', {
  schema: {
    querystring: {
      type: 'object',
      properties: {
        name: { type: 'string' },
        age: { type: 'integer' }
      },
      required: ['name']
    }
  }
}, async (request) => {
  // 此时request.query会正确推断为{ name: string; age?: number }
  const { name, age } = request.query;
  return { message: `Hello ${name}, age: ${age ?? 'unknown'}` };
});

3. 检查TypeScript配置 #

确保tsconfig.json开启必要的类型检查选项：

{
  "compilerOptions": {
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "moduleResolution": "node",
    "target": "ES2020",
    "module": "CommonJS"
  }
}

• strict模式是Fastify类型推断生效的核心前提，关闭会导致类型丢失

4. 修正JSON Schema定义错误 #

• 确保querystring的Schema类型明确为object
• 不要遗漏required字段，否则可选属性会被推断为undefined，但整体类型不会丢失
• 仅使用标准JSON Schema Draft 7及以上语法，避免非标准扩展

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