Electron+Vite+Vue项目Sequelize调用moment.isMoment报错求助

问题背景 #

技术栈为 Electron + Vite + Vue，使用 Sequelize 操作 MSSQL 数据库，定义包含 DATE 类型字段的模型后，在渲染进程调用 Operation.create() 创建对象时触发如下错误：

Uncaught (in promise) TypeError: moment.isMoment is not a function
    at DATE2._stringify (data-types.js:472:17)
    at DATE2.stringify (data-types.js:24:19)
    at DATE2.bindParam (data-types.js:32:35)
    at MSSQLQueryGenerator.format (query-generator.js:1147:29)
    at MSSQLQueryGenerator.insertQuery (query-generator.js:193:30)
    at MSSqlQueryInterface.insert (query-interface.js:790:37)
    at OperationVisualControl.save (model.js:4154:73)
    at async OperationVisualControl.create (model.js:2305:12)

模型定义代码：

Operation.init({
  itemId: {
    type: DataTypes.STRING
  },
  startDate: {
    type: DataTypes.DATE,
  },
  endDate: {
    type: DataTypes.DATE,
  },
  code: {
    type: DataTypes.STRING
  }
}, {
  sequelize, 
  modelName: 'Operation',
  timestamps: false
})

已尝试调整多种 Vite 配置，问题未解决。

排查方向与解决方案 #

1. 手动挂载 moment 到全局 #

Sequelize 处理 DATE 类型时依赖 moment，但 Vite 在渲染进程中可能未正确加载 moment，导致 Sequelize 无法访问 moment.isMoment 方法。在渲染进程入口文件（如 src/main.ts）中手动引入并挂载：

import moment from 'moment'
window.moment = moment

2. 配置 Vite 避免 moment 被 tree-shaking #

Vite 的 tree-shaking 可能误删 moment 必要模块，在 vite.config.ts 中添加优化配置：

export default defineConfig({
  // ...其他配置
  optimizeDeps: {
    include: ['moment', 'sequelize']
  },
  build: {
    commonjsOptions: {
      include: [/moment/, /sequelize/, /node_modules/]
    }
  }
})

3. 匹配 Sequelize 与 moment 的版本兼容性 #

部分 Sequelize 版本对 moment 版本有明确要求，查看 Sequelize 的 package.json 依赖的 moment 版本范围，安装对应版本：

npm install moment@x.x.x # 替换为 Sequelize 要求的具体版本

4. 迁移数据库操作到主进程（Electron 最佳实践） #

渲染进程直接操作数据库存在安全风险且易引发依赖问题，建议将数据库逻辑移至主进程，通过 IPC 通信调用：

• 主进程封装操作：

// main.js
const { ipcMain } = require('electron')
const { Operation } = require('./models')

ipcMain.handle('create-operation', async (_, data) => {
  return await Operation.create(data)
})

• 渲染进程调用：

// 组件内代码
import { ipcRenderer } from 'electron'

async function createOperation(data) {
  try {
    const result = await ipcRenderer.invoke('create-operation', data)
    console.log(result)
  } catch (err) {
    console.error(err)
  }
}

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