Node.js TypeScript项目路由文件构建报错求助

我创建了一个路由文件，代码如下：

import express, { NextFunction, Request, Response } from "express";

const router = express.Router();

router.post(
  "/product",
  async (req: Request, res: Response, next: NextFunction) => {
    return res.status(200).json({});
  }
);

export default router;

该文件第7行出现红线提示，本地运行代码一切正常，但执行项目构建并运行构建后的代码时抛出错误。曾尝试添加Promise返回类型，但问题仍未解决。

问题根源 #

这是TypeScript类型不匹配导致的问题：async函数会自动把返回值包装成Promise，但Express的路由处理函数类型定义里，不期望函数返回Promise——Express是通过res对象发送响应，而非依赖处理函数的返回值，返回res.status(200).json({})会触发类型冲突。本地开发可能因为TypeScript宽松编译选项（比如noImplicitReturns未开启）不报错，但构建时严格模式下就会抛出错误。

解决方案 #

1. 正确指定返回类型并移除不必要的return

修改async函数，明确返回Promise<void>，并且不返回res对象的调用结果：

router.post(
  "/product",
  async (req: Request, res: Response, next: NextFunction): Promise<void> => {
    res.status(200).json({});
  }
);

这样既符合TypeScript的类型要求，也契合Express的响应处理逻辑。

2. 检查@types/express与express版本兼容性

如果上述方法无效，可能是类型定义包和Express核心包版本不匹配引发的类型冲突：

• 确保package.json中express和@types/express的主版本一致（比如都是4.x）
• 执行npm install @types/express@latest更新类型定义包，或者锁定匹配的版本号

3. 调整TypeScript编译选项（临时方案）

如果暂时无法调整代码或依赖，可以在tsconfig.json中放宽相关编译规则，但不推荐长期使用：

• 关闭noImplicitReturns选项
• 开启skipLibCheck跳过类型库的检查

内容的提问来源于stack exchange，提问作者Muhammad Umais Hassan