创建JupiterClient实例时报TypeError: *.default非构造函数的解决方法

你遇到的核心问题是自定义的类型声明和client-nodejs模块实际的导出结构不匹配，导致TypeScript的类型提示和运行时的导出逻辑对不上。咱们一步步来排查解决：

第一步：先确认模块的真实导出方式 #

去项目的node_modules/client-nodejs目录下，找到模块的入口文件（可以看package.json里的main字段定位），看看它是怎么导出JupiterClient的：

• 如果是CommonJS风格：

  // 两种常见写法
  module.exports = JupiterClient;
  // 或者
  module.exports = { JupiterClient };
  

• 如果是ES模块风格：

  // 两种常见写法
  export default JupiterClient;
  // 或者
  export class JupiterClient { ... }
  

第二步：根据真实导出修正类型声明 #

情况1：模块是默认导出（不管CommonJS还是ES模块） #

如果入口文件是module.exports = JupiterClient或者export default JupiterClient，你的类型声明可以保留export default，但导入写法需要适配CommonJS的导出逻辑：

// 类型声明文件保持不变（记得补上JupiterClientOptions的定义）
declare module "client-nodejs" {
  export default class JupiterClient {
    constructor(options: JupiterClientOptions);
  }
  interface JupiterClientOptions {
    // 这里填入实际需要的配置字段，比如apiKey、accountId等
  }
}

// 改用require风格的导入（适配CommonJS模块的默认导出）
import JupiterClient = require('client-nodejs');
const j1Client = new JupiterClient(j1ClientOptions);

要是你的tsconfig.json里开启了allowSyntheticDefaultImports和esModuleInterop，也可以继续用import JupiterClient from 'client-nodejs'，但require的写法在CommonJS模块场景下更稳妥。

情况2：模块是命名导出 #

如果入口文件是module.exports = { JupiterClient }或者export class JupiterClient，那类型声明要改成命名导出：

declare module "client-nodejs" {
  export class JupiterClient {
    constructor(options: JupiterClientOptions);
  }
  interface JupiterClientOptions {
    // 配置字段
  }
}

// 用命名导入即可
import { JupiterClient } from 'client-nodejs';
const j1Client = new JupiterClient(j1ClientOptions);

第三步：检查TypeScript配置 #

确保tsconfig.json里的模块解析配置和你的项目环境匹配：

• Node.js环境下，moduleResolution设为node
• 若需要兼容CommonJS模块的默认导出，开启allowSyntheticDefaultImports和esModuleInterop

调整完这些，应该就能解决导入和实例化的错误了。

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