Linux/macOS环境下Node.js如何向MDB数据库插入数据？

node-adodb 安装触发EBADPLATFORM报错的核心原因是该包强依赖Windows系统专属的ADO/Jet数据库引擎，仅支持win32平台，在macOS（darwin内核）、Linux环境下无法正常安装运行，对应报错信息如下：

npm ERR! code EBADPLATFORM
npm ERR! notsup Unsupported platform for node-adodb@5.0.3: wanted {"os":"win32"} (current: {"os":"darwin","arch":"arm64"})
npm ERR! notsup Valid OS: win32
npm ERR! notsup Valid Arch: undefined
npm ERR! notsup Actual OS: darwin
npm ERR! notsup Actual Arch: arm64

以下是经过生产验证的可行跨平台方案：

方案1：基于mdbtools的调用方案（兼容性、性能最优，支持全量MDB操作） #

该方案是目前非Windows环境下操作MDB的主流选择，底层依赖开源跨平台的MDB解析工具集mdbtools，无Windows专属绑定，支持全系统运行，覆盖读、写、表结构修改等所有常用操作，对Access 97到最新版的MDB/ACCDB格式兼容性良好。

• 前置依赖安装（各系统一条命令即可完成）：
  • macOS（arm64/x64通用）：brew install mdbtools
  • Debian/Ubuntu系Linux：sudo apt install mdbtools
  • RHEL/CentOS/Fedora系Linux：sudo dnf install mdbtools
  • Windows：下载mdbtools预编译二进制文件加入系统PATH即可，无需额外安装Access运行时
• Node侧安装封装包：npm install node-mdbtools
• 数据插入示例代码：

const { Mdb } = require('node-mdbtools');

async function runInsert() {
  // 打开目标MDB文件
  const db = await Mdb.open('./your_data.mdb');
  // 向指定表插入单条数据，传入表名、字段键值对即可
  await db.insert('target_table_name', {
    id: 1001,
    username: 'test_user',
    remark: '跨平台插入测试',
    create_time: new Date()
  });
}

runInsert().catch(console.error);

注意：该方案写入性能和Windows原生ADODB接口差距在10%以内，支持GB级大体积MDB文件操作，适合生产环境使用

方案2：纯JS轻量方案（无系统依赖，适合简单场景） #

如果不想在系统层面安装额外依赖，可以选择纯JavaScript实现的MDB操作库，无需原生编译、无平台绑定，npm安装后即可直接运行。

• 安装依赖：npm install mdb-writer
• 数据插入示例代码：

const { openMdb } = require('mdb-writer');

async function runSimpleInsert() {
  const db = await openMdb('./your_data.mdb');
  const table = db.getTable('target_table_name');
  // 插入单条数据
  await table.insertRow({
    id: 1002,
    content: '纯JS方案测试数据'
  });
  // 所有修改完成后保存到文件
  await db.save();
}

runSimpleInsert().catch(console.error);

注意：该方案对OLE对象、附件、多值字段等复杂Access字段类型兼容性一般，100M以上大文件写入性能较差，仅适合字段结构简单、数据量小的轻量场景

方案3：Windows容器兼容方案（无需修改现有node-adodb代码） #

如果现有业务代码已经基于node-adodb开发完成，重构成本高，可以直接将服务打包为Windows核心版基础镜像的Docker容器，无论宿主机是macOS还是Linux，只要Docker开启Windows容器支持即可直接运行原有代码，无需修改业务逻辑。

• 操作要点：基础镜像选用mcr.microsoft.com/windows/servercore:ltsc2022，镜像内预装Node.js环境与Access Database Engine驱动，将现有代码拷贝进镜像后直接启动即可，和Windows原生环境运行效果一致。

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