TypeScript动态导出代理包装函数后无法导入的问题解决

问题根源 #

你遇到的报错是因为TypeScript的静态类型检查机制无法识别运行时动态添加到exports的导出项。原代码仅在运行时给exports挂载代理函数，但编译阶段TypeScript认为services/index.ts没有显式导出这些函数，因此报“模块中不存在该函数”的错误。

解决方案 #

方案一：复用Legacy模块类型 + 运行时代理替换 #

这是最简洁高效的方案，既让TypeScript识别所有导出类型，又能在运行时替换为代理函数：

修改services/index.ts代码如下：

import * as legacyServiceFns from './legacy';

// 关键：通过export *让TypeScript识别所有legacy模块的导出类型
export * from './legacy';

// 运行时将每个导出函数替换为代理版本
Object.keys(legacyServiceFns).forEach((fnName) => {
  const originalFn = legacyServiceFns[fnName as keyof typeof legacyServiceFns];
  if (typeof originalFn === 'function') {
    (exports as any)[fnName] = new Proxy(originalFn, {
      apply(target, thisArg, args) {
        // 调用前的自定义操作（比如日志、权限校验等）
        console.log(`[Proxy] 执行旧函数: ${fnName}`);
        // 执行原函数逻辑
        return target.apply(thisArg, args);
      }
    });
  }
});

方案二：自定义类型声明文件（适合函数数量较少的场景） #

如果不想通过export *导出所有legacy成员，可以手动创建类型声明文件匹配动态导出的类型：

1. 在services目录下创建index.d.ts：

import type * as legacy from './legacy';

// 逐个声明要导出的函数类型
export declare const legacyFn1: typeof legacy.legacyFn1;
export declare const legacyFn2: typeof legacy.legacyFn2;
// ... 其他函数依次声明

2. 保持原代理逻辑不变，此时TypeScript会通过类型声明文件识别导出项，不再报错。

验证效果 #

修改完成后，直接导入调用函数即可：

import { legacyFn1 } from './services';
legacyFn1(); // 会先执行代理中的前置操作，再调用原函数逻辑

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