Fastify(TypeScript)中request.params及请求500报错问题求助

1. 解决req.params.id报null的异常 #

虽然你打印出req.params为{ id: '1' }，但报错提示无法读取null的id，核心原因是类型定义与运行时参数解析不匹配，或路由参数校验配置有误：

• 检查ParamsType定义，确保id为必填项：

  type ParamsType = {
    id: string; // 不要加可选符?
  };
  

• 显式指定请求的参数类型，避免类型推断错误：

  handler: async (req: FastifyRequest<{ Params: ParamsType }>) => {
    const { id } = req.params;
    return repository.read(id);
  }
  

• 确认schema.params校验规则正确，开启参数校验避免非法请求：

  const getOpts = {
    schema: {
      params: {
        type: 'object',
        required: ['id'],
        properties: {
          id: { type: 'string' }
        }
      }
    },
    // handler...
  };
  

2. 处理IDE中getOpts的下划线提示 #

下划线提示通常是类型不匹配导致，虽无编译警告，但需对齐Fastify路由选项类型：

• 显式指定getOpts的类型为FastifyRouteOptions：

  import type { FastifyRouteOptions } from 'fastify';
  
  const getOpts: FastifyRouteOptions<{ Params: ParamsType }> = {
    schema: { /* 你的校验配置 */ },
    handler: /* 你的处理逻辑 */
  };
  

3. 额外排查点 #

• 确认路由注册方式正确，getOpts已传入fastify.get：

  fastify.get('/your-endpoint/:id', getOpts);
  

• 检查repository.read(id)的参数类型要求，如果期望数字类型，需先转换：const id = parseInt(req.params.id, 10);，避免因参数类型不兼容引发的隐性报错。

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