TypeScript项目如何解决邮件发送与错误处理模块的循环依赖问题

针对邮件模块和错误处理模块的双向依赖场景，可根据项目规模选择以下三种符合规范的修复方案：

方案1：运行时动态导入（改造成本最低） #

ES模块支持运行时异步导入，无需在代码顶层声明依赖，直接打破循环依赖链，适合快速修复现有问题：

// error-handler.js 移除顶层邮件模块导入，触发告警时动态加载
async function err(e) {
  writeErrorToDB(e)
  const { default: sendEmail } = await import("emailer.js")
  sendEmail("Error Occurred", e)
}

如果使用CommonJS规范，直接把导入语句放到函数内部即可：

// emailer.js CommonJS场景示例
function sendEmail() {
  try { trySendEmail() } 
  catch(e) {
    const err = require("error-handler.js")
    err(e)
  }
}

方案2：抽离公共调度层（扩展性最优） #

将告警渠道的注册、触发逻辑抽离为独立公共模块，两个业务模块都只依赖公共层，从设计层面解除耦合：

1. 新增公共层alert-channel.js，无任何外部依赖：

const alertChannels = []
// 注册告警渠道（邮件、短信、企微等都可注册）
export function registerAlertChannel(channelFn) {
  alertChannels.push(channelFn)
}
// 统一触发所有告警渠道
export function triggerAlert(...args) {
  alertChannels.forEach(fn => fn(...args))
}

2. 改造错误处理模块，只依赖公共层：

import { triggerAlert } from "./alert-channel.js"
export default function err(e) {
  writeErrorToDB(e)
  triggerAlert("Error Occurred", e)
}

3. 改造邮件模块，启动时注册自身为告警渠道：

import err from "./error-handler.js"
import { registerAlertChannel } from "./alert-channel.js"

// 模块初始化时注册邮件告警渠道
registerAlertChannel(sendEmail)

export default function sendEmail(title, content) {
  try { trySendEmail(title, content) } 
  catch(e) { err(e) }
}

该方案符合单一职责原则，后续新增告警渠道无需修改错误处理模块逻辑。

方案3：依赖注入（完全解耦，适合大型项目） #

两个模块都不直接导入对方，依赖由上层入口统一注入，彻底解除模块间的直接依赖：

1. 改造错误处理模块，接收告警方法作为入参：

// error-handler.js 无需导入邮件模块
export default function createErrorHandler(sendAlert) {
  return function err(e) {
    writeErrorToDB(e)
    sendAlert("Error Occurred", e)
  }
}

2. 改造邮件模块，支持注入错误处理方法：

// emailer.js 无需导入错误处理模块
let errorHandler
export function initEmailer(handler) {
  errorHandler = handler
}

export default function sendEmail(title, content) {
  try { trySendEmail(title, content) } 
  catch(e) { errorHandler(e) }
}

3. 项目入口文件统一组装依赖：

import sendEmail from "./emailer.js"
import createErrorHandler from "./error-handler.js"
import { initEmailer } from "./emailer.js"

// 注入邮件方法生成错误处理实例
const err = createErrorHandler(sendEmail)
// 注入错误处理实例初始化邮件模块
initEmailer(err)

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