如何动态导入引用自身的模块？解决Express循环导入问题

你的方案中app.js和路由模块互相导入，形成了循环引用：app.js动态加载路由时，路由模块又去导入app.js，此时app.js还处于执行阶段，模块依赖链陷入循环，导致异常。下面提供两种解决方案，既能保持你想要的开发体验（DX），又能解决循环问题：

方案1：拆分app实例到独立模块 #

这种方案可以让你完全保留路由里直接引用app的写法：

1. 创建app-instance.js，专门负责创建并导出Express实例：

import express from 'express'
export const app = express()

2. 修改app.js，从app-instance.js引入实例，再动态加载路由：

import { app as expressApp } from './app-instance.js'
import { globby } from 'globby'
import path from 'path'

// 动态加载所有路由文件
const routePaths = await globby(['./routes/**/*.js'])
for (const routePath of routePaths) {
    await import(path.resolve(routePath))
}

// 重新导出app，让路由可以继续从app.js导入
export const app = expressApp
export default expressApp

3. 路由文件（比如routes/index.js）无需修改，依然保持你想要的写法：

import { app } from '../app.js'

app.get('/', (req, res) => {
    res.send('Hello World!')
})

原理：app-instance.js只负责创建实例，不依赖任何路由模块；app.js依赖app-instance.js和路由模块；路由模块依赖app.js时，app实例已经从app-instance.js准备完成并导出，不会出现循环依赖导致的未定义问题。

方案2：使用Express Router（推荐的模块化写法） #

如果你可以接受稍微调整路由写法，这种方案更符合Express的模块化设计，从根源避免循环引用：

1. 修改路由文件，导出Router实例：

import { Router } from 'express'

const router = Router()
router.get('/', (req, res) => {
    res.send('Hello World!')
})

export default router

2. 修改app.js，动态导入路由并挂载：

import express from 'express'
import { globby } from 'globby'
import path from 'path'

const app = express()

const routePaths = await globby(['./routes/**/*.js'])
for (const routePath of routePaths) {
    const router = (await import(path.resolve(routePath))).default
    // 可根据需求添加统一路由前缀，比如 app.use('/api', router)
    app.use(router)
}

export default app

这种写法虽然路由里不能直接使用app，但模块划分更清晰，后续维护和扩展更方便，也是Express官方推荐的路由组织方式。

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