Typescript结合Express报错：No Overload matches this call

这个错误源于editSystemUser函数的类型与Express路由处理函数的预期类型不匹配——TypeScript无法推断出req.params.id和req.body的结构，导致函数签名不符合Express的RequestHandler类型要求。以下是具体修复方案：

步骤1：定义请求参数和请求体的接口 #

在SystemUserController.ts中，先明确请求参数和请求体的结构：

import { Request, Response, RequestHandler } from 'express';
import bcrypt from 'bcrypt';
import SystemUser from '../models/SystemUser'; // 确保导入你的用户模型

// 更新用户的URL参数类型
interface UpdateUserParams {
  id: string;
}

// 更新用户的请求体类型
interface UpdateUserBody {
  first_name?: string;
  middle_name?: string;
  last_name?: string;
  username?: string;
  email?: string;
  password?: string;
  is_active?: boolean;
}

步骤2：修正editSystemUser函数的类型声明 #

有两种方式可以修复类型不匹配问题：

方式一：使用泛型版Request

给req参数指定泛型，明确params和body的结构：

export const editSystemUser = async (
  req: Request<UpdateUserParams, {}, UpdateUserBody>,
  res: Response
): Promise<void> => {
  const { id } = req.params;
  const { first_name, middle_name, last_name, username, email, password, is_active } = req.body;

  try {
    const user = await SystemUser.findById(id);
    if (!user) {
      res.status(404).json({ message: '用户未找到' });
      return;
    }

    if (password) {
      const salt = await bcrypt.genSalt(10);
      user.password = await bcrypt.hash(password, salt);
    }

    user.first_name = first_name || user.first_name;
    user.middle_name = middle_name || user.middle_name;
    user.last_name = last_name || user.last_name;
    user.username = username || user.username;
    user.email = email || user.email;
    user.is_active = is_active !== undefined ? is_active : user.is_active;

    await user.save();
    res.status(200).json({ message: '用户已更新', user });
  } catch (error) {
    console.error(error);
    res.status(500).json({ message: '服务器错误' });
  }
};

方式二：直接使用RequestHandler类型

将函数类型声明为RequestHandler，无需单独指定req/res类型：

export const editSystemUser: RequestHandler<UpdateUserParams, {}, UpdateUserBody> = async (req, res) => {
  // 函数逻辑与方式一完全一致
};

步骤3：路由文件无需修改 #

你的systemUserRoutes.ts代码保持原样即可，只要控制器函数类型正确，路由就能正常匹配。

额外说明 #

• 原函数返回Promise<Response | undefined>无必要，Express异步路由处理函数只需调用res.send/res.json等方法，返回Promise<void>更符合预期。
• 明确的接口定义能让TypeScript提供更精准的类型检查，提前规避运行时错误。

内容的提问来源于stack exchange，提问作者Ümit Çamurcuk