如何解决Node.js中的循环依赖问题？满足指定约束条件

问题场景 #

现有三个JavaScript文件存在循环依赖：controller.js → cleanhouse.js → cleankitchen.js → controller.js，调用start()时无法正常输出预期日志，需在以下约束下修复：

• cleanhouse()必须保留在专属文件，函数体不可修改
• cleankitchen()必须保留在专属文件，函数体不可修改
• 仅允许修改controller.js，可给另外两个文件添加少量样板代码（不得改动核心函数逻辑）

解决方案 #

通过CommonJS模块的导出/导入机制调整加载顺序，确保循环依赖中所需函数能被正确获取，同时完全保留核心函数的原有逻辑：

修改后的代码 #

controller.js（仅修改此文件的结构与导出逻辑）

// 优先导出finish，确保循环依赖时其他模块能获取到该函数
exports.finish = finish;

function start() { 
  console.log("Housecleaning has begun!");
  cleanhouse(); 
}

function finish() { 
  console.log("Housecleaning done!"); 
}

// 最后导入cleanhouse，避免加载顺序导致的未定义问题
const { cleanhouse } = require("./cleanhouse.js");
// 导出start供外部调用
exports.start = start;

cleanhouse.js（仅添加导出样板，核心函数未改动）

const { cleankitchen } = require("./cleankitchen.js");

function cleanhouse() { cleankitchen(); }

// 导出cleanhouse函数
exports.cleanhouse = cleanhouse;

cleankitchen.js（仅调整导入方式，核心函数未改动）

// 从controller导入已导出的finish函数
const { finish } = require("./controller.js");

function cleankitchen() { finish(); }

// 导出cleankitchen函数
exports.cleankitchen = cleankitchen;

生效原理 #

CommonJS模块在处理循环依赖时，会返回当前已完成导出的部分内容。通过让controller.js先导出finish函数，再导入依赖的cleanhouse，cleankitchen.js在加载时就能获取到已导出的finish，避免了函数未定义的错误。所有核心函数的逻辑完全保留，仅添加了必要的模块导出/导入样板代码，完全符合约束要求。

测试调用 #

在入口文件中执行：

const { start } = require("./controller.js");
start();

将输出预期内容：

Housecleaning has begun!
Housecleaning done!

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