部署NestJS到Vercel时Swagger出现TS2349错误求助

问题根源 #

这个错误是因为express-basic-auth的导入方式不正确导致的。该包的默认导出是可调用的认证中间件函数，但你用import * as basicAuth的方式导入时，得到的是包含默认导出的模块对象，而非直接的函数，所以调用basicAuth({...})会提示“无调用签名”。

解决方案 #

1. 修正导入语句 #

将导入代码从：

import * as basicAuth from 'express-basic-auth';

改为默认导入：

import basicAuth from 'express-basic-auth';

如果项目使用CommonJS模块规范（比如tsconfig.json中module设置为CommonJS），也可以用以下方式：

const basicAuth = require('express-basic-auth').default;

2. 确保依赖版本一致 #

本地运行正常但Vercel部署报错，大概率是依赖版本不一致导致的：

• 确认package-lock.json或yarn.lock文件已提交到代码仓库，让Vercel安装与本地完全相同的依赖版本。
• 若未锁定版本，可手动指定express-basic-auth的版本号（比如"express-basic-auth": "^1.2.1"），避免Vercel安装最新版本带来的类型定义变化。

3. 检查TypeScript配置差异 #

Vercel构建环境可能使用了与本地不同的TS配置：

• 对比本地tsconfig.json和Vercel构建时的配置，重点检查moduleResolution、esModuleInterop、allowSyntheticDefaultImports这几个选项，确保开启esModuleInterop和allowSyntheticDefaultImports（设置为true），让TypeScript正确处理第三方包的默认导出。

4. 补充类型定义（可选） #

如果上述步骤无效，可手动安装类型定义包（部分旧版本的express-basic-auth可能自带类型存在问题）：

npm install @types/express-basic-auth --save-dev

验证修改 #

修改后，本地先执行npm run build确认编译正常，再重新部署到Vercel，即可解决该类型错误。

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