Node.js+Tap报错：Class extends value undefined 排查求助

核心原因：错误的导出方式导致继承对象非构造函数 #

你的问题根源出在App类的导出逻辑上：
在App的代码文件中，你先定义了App类，然后实例化并通过module.exports = app导出了实例对象，而非App类本身。当TestSuite尝试继承App时，实际拿到的是一个已经实例化的对象（甚至可能是undefined，取决于导入方式），而非可继承的类构造函数，因此触发TypeError: Class extends value undefined is not a constructor or null。

你提到单独运行TestSuite时正常，大概率是因为单独运行时的导入逻辑巧合避开了这个问题（比如用ES模块import { App } from './App'拿到了类的命名导出，但混合ES/CommonJS导出的行为在不同运行环境下可能不一致），但在Tap测试环境下，CommonJS的导入优先级更高，直接拿到了module.exports的实例，导致继承失败。

而当TestSuite继承AbstractApplication时，因为AbstractApplication文件正确导出了类构造函数，所以不会触发继承错误，仅出现测试未完成的问题（通常是测试用例缺少断言或未正确结束）。

解决方案 #

1. 修正App文件的导出逻辑，同时导出类和实例 #

修改App文件，确保既导出App类供继承使用，又导出实例供业务代码调用：

// App.ts
export abstract class AbstractApplication {
    abstract beforeStart(): void
    abstract afterStart(): void
} 

export class App extends AbstractApplication {
  // 实现AbstractApplication的特定方法
  async startApp(): void {
     // 业务逻辑
  }

  beforeStart(): void { /* 实现抽象方法 */ }
  afterStart(): void { /* 实现抽象方法 */ }
}

// 同时导出类和实例
export const app: App = new App()
// 兼容CommonJS导入
module.exports = { App, app }

2. 修正TestSuite的导入逻辑 #

在TestSuite文件中，明确导入App类而非实例：

// TestSuite.ts
const { App } = require("./App")

export class TestSuite extends App {
    async startApp(): Promise<void> {
        console.log("READY")
    }
}

const testSuite = new TestSuite()
module.exports = testSuite

3. 统一模块系统（可选但推荐） #

避免混合使用ES模块（export/import）和CommonJS（module.exports/require），减少导出导入的混乱：

• 在package.json中添加"type": "module"，统一使用ES模块语法；
• 或者全部改用CommonJS语法，将export class改为class ...; module.exports = { ... }。

4. 排查循环依赖（辅助检查） #

虽然当前问题核心是导出错误，但也可以快速检查是否存在循环导入：比如App文件是否间接导入了TestSuite，或者测试文件是否被其他业务文件反向导入。如果存在循环依赖，可通过延迟导入（比如在函数内部require）或重构代码拆分依赖来解决。

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