NextJS自定义服务器模块重复加载问题求助

问题背景 #

在NextJS自定义服务器应用中，多次导入同一模块（如import { registerStartOfGuildTriviaListener } from '@/lib/trivia-manager';）时，模块会被重复加载，无法复用已加载的实例。模块内存储的全局复用数据会被重新初始化，导致无法正常读取。已尝试替换路径别名@为绝对路径，问题仍存在，使用npx tsx server.ts运行项目，附tsconfig.json配置：

{
  "compilerOptions": {
    "lib": [
      "dom",
      "dom.iterable",
      "esnext"
    ],
    "typeRoots": [
      "./types"
    ],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "plugins": [
      {
        "name": "next"
      }
    ],
    "baseUrl": ".",
    "paths": {
      "@/*": [
        "./*"
      ],
    }
  },
  "include": [
    "next-env.d.ts",
    "**/*.ts",
    "**/*.tsx",
    ".next/types/**/*.ts"
  ],
  "exclude": [
    "node_modules"
  ]
}

可能原因 #

• tsx的ES模块解析逻辑与Node.js原生解析存在差异，导致同一模块被识别为不同模块
• NextJS自定义服务器的模块缓存机制与tsx运行时缓存不兼容
• isolatedModules: true配置强制模块单独编译，影响模块复用逻辑

解决步骤 #

1. 统一导入路径格式 #

• 确保所有导入同一模块的语句使用完全一致的路径，避免混合使用路径别名、绝对路径、相对路径
• 检查文件系统大小写敏感问题，比如@/Lib/trivia-manager和@/lib/trivia-manager会被视为不同模块

2. 调整tsx运行参数 #

运行tsx时添加--experimental-specifier-resolution=node参数，强制使用Node.js原生模块解析逻辑：

npx tsx --experimental-specifier-resolution=node server.ts

3. 修改tsconfig.json配置 #

• 将moduleResolution和module改为NodeNext，贴近Node.js模块解析行为：

  "module": "NodeNext",
  "moduleResolution": "NodeNext"
  

• 若不影响其他编译需求，可暂时关闭isolatedModules验证是否解决问题：

  "isolatedModules": false
  

4. 手动实现单例模式（兜底方案） #

在模块内手动实现单例，确保数据仅初始化一次：

// @/lib/trivia-manager.ts
class TriviaManager {
  private static instance: TriviaManager;
  // 全局共享数据
  public triviaData = {};

  private constructor() {}

  public static getInstance(): TriviaManager {
    if (!TriviaManager.instance) {
      TriviaManager.instance = new TriviaManager();
    }
    return TriviaManager.instance;
  }

  registerStartOfGuildTriviaListener() {
    // 业务逻辑实现
  }
}

export const triviaManager = TriviaManager.getInstance();
export const { registerStartOfGuildTriviaListener } = triviaManager;

导入时直接使用该单例实例，确保全应用共享同一数据：

import { triviaManager, registerStartOfGuildTriviaListener } from '@/lib/trivia-manager';

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