使用pnpm构建项目时遭遇TS2742错误，求解决方案

构建时触发如下错误：

vite v4.3.9 building for production...
✓ 2781 modules transformed.
dist/style.css             2.63 kB │ gzip:   0.95 kB
dist/rd-component.es.js  452.49 kB │ gzip: 155.89 kB │ map: 1,267.35 kB
No name was provided for external module "react-redux" in "output.globals" – guessing "reactRedux".
No name was provided for external module "redux" in "output.globals" – guessing "redux".
dist/rd-component.umd.js  334.60 kB │ gzip: 140.90 kB │ map: 1,229.84 kB

[vite:dts] Start generate declaration files...
src/service/order/OrderService.ts:5:14 - error TS2742: The inferred type of 'OrderService' cannot be named without a reference to '.pnpm/rdjs-wheel@0.0.7_@babel+core@7.22.1_esbuild@0.17.19_rollup@3.23.1_typescript@5.1.3/node_modules/rdjs-wheel'. This is likely not portable. A type annotation is necessary.

5 export const OrderService = {
               ~~~~~~~~~~~~
src/service/pay/PayService.ts:6:14 - error TS2742: The inferred type of 'PayService' cannot be named without a reference to '.pnpm/rdjs-wheel@0.0.7_@babel+core@7.22.1_esbuild@0.17.19_rollup@3.23.1_typescript@5.1.3/node_modules/rdjs-wheel'. This is likely not portable. A type annotation is necessary.

6 export const PayService = {
               ~~~~~~~~~~

✓ built in 5.58s
[vite:dts] Declaration files built in 1992ms.

PayService代码实现 #

import { PayActionType } from '@/action/pay/PayAction';
import { XHRClient } from '@/common/XHRClient';
import { IOrder } from '@/models/pay/IOrder';
import { AnyAction, Store } from 'redux';

export const PayService = {
    doPay:(params: any, store: Store<any, AnyAction>)=>{
        const config = {
            method: 'post',
            url: '/post/alipay/pay/createOrder',
            headers: { 'Content-Type': 'application/json' },
            data: JSON.stringify(params)
        };
        const actionTypeString: string = PayActionType[PayActionType.CREATE_ORDER];
        return XHRClient.requestWithActionType(config, actionTypeString, store);
    },
    setPayedInfo: (order: IOrder, store: Store<any, AnyAction>) => {
        const actionTypeString: string = PayActionType[PayActionType.SET_PAYED_ORDER_INFO];
        const action = {
            type: actionTypeString,
            data: order
        };
        store.dispatch(action);
    },
    doClearAlipayFormText: (store: Store<any, AnyAction>) => {
        const actionTypeString: string = PayActionType[PayActionType.CLEAR_ALIPAY_FORM_TEXT];
        const action = {
            type: actionTypeString,
            data: ''
        };
        store.dispatch(action);
    }
}

export default PayService;

tsconfig.json配置 #

{
  "compilerOptions": {
    "typeRoots": [
      "./typings"
    ],
    "types": [
      "@types/jest"
    ],
    "outDir": "./dist",
    "baseUrl": "./",
    "paths": {
      "@/*": [
        "src/*",
      ]
    },
    "target": "es5",
    "lib": [
      "dom",
      "dom.iterable",
      "esnext"
    ],
    "declaration": true,
    "allowJs": false,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "noFallthroughCasesInSwitch": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": false,
    "jsx": "react-jsx"
  },
  "include": [
    "src",
    "typings/typings.d.ts"
  ],
  "test": {
    "compilerOptions": {
      "jsx": "react-jsx"
    }
  }
}

已尝试删除node_modules重新安装依赖，问题未解决，求可行方案。

1. 给服务对象添加显式类型注解 #

TS2742错误的核心是：TypeScript自动推断的类型依赖了第三方包rdjs-wheel的内部类型，导致生成声明文件时无法正常引用外部包路径。直接给PayService和OrderService定义显式接口，完全规避类型推断的依赖问题。

修改PayService.ts：

import { PayActionType } from '@/action/pay/PayAction';
import { XHRClient } from '@/common/XHRClient';
import { IOrder } from '@/models/pay/IOrder';
import { AnyAction, Store } from 'redux';

// 定义PayService的显式接口
interface IPayService {
  doPay: (params: any, store: Store<any, AnyAction>) => ReturnType<typeof XHRClient.requestWithActionType>;
  setPayedInfo: (order: IOrder, store: Store<any, AnyAction>) => void;
  doClearAlipayFormText: (store: Store<any, AnyAction>) => void;
}

// 给PayService指定显式类型
export const PayService: IPayService = {
    doPay:(params: any, store: Store<any, AnyAction>)=>{
        const config = {
            method: 'post',
            url: '/post/alipay/pay/createOrder',
            headers: { 'Content-Type': 'application/json' },
            data: JSON.stringify(params)
        };
        const actionTypeString: string = PayActionType[PayActionType.CREATE_ORDER];
        return XHRClient.requestWithActionType(config, actionTypeString, store);
    },
    setPayedInfo: (order: IOrder, store: Store<any, AnyAction>) => {
        const actionTypeString: string = PayActionType[PayActionType.SET_PAYED_ORDER_INFO];
        const action = {
            type: actionTypeString,
            data: order
        };
        store.dispatch(action);
    },
    doClearAlipayFormText: (store: Store<any, AnyAction>) => {
        const actionTypeString: string = PayActionType[PayActionType.CLEAR_ALIPAY_FORM_TEXT];
        const action = {
            type: actionTypeString,
            data: ''
        };
        store.dispatch(action);
    }
}

export default PayService;

同理，给OrderService添加对应的显式接口和类型注解即可。

2. 调整tsconfig.json配置（可选补充） #

如果显式类型注解仍未完全解决问题，可尝试修改以下配置：

• 添加"declarationMap": false：关闭声明文件的sourceMap，避免生成的.d.ts文件引用node_modules路径
• 确认"skipLibCheck": true已开启：跳过第三方库的类型检查，避免外部包的类型问题干扰构建

修改后的compilerOptions片段：

"compilerOptions": {
  // ...其他原有配置
  "declaration": true,
  "declarationMap": false,
  "skipLibCheck": true,
  // ...其他原有配置
}

3. 检查第三方包rdjs-wheel的类型定义 #

如果上述方法均无效，说明rdjs-wheel包的类型导出存在缺陷：

• 确认该包是否包含正确的.d.ts类型文件
• 若没有类型文件，可在项目的typings目录下手动补充该包的类型声明
• 联系包作者修复类型导出问题

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