Node.js ES模块环境下使用mysql模块遇require未定义问题求助

算力阿峰

2026-8-8

在ES模块Node.js项目中使用mysql@2.18.1的解决方案

mysql@2.x版本是纯CommonJS模块，未提供ES模块导出，因此在启用"type": "module"的项目里直接用require会触发语法兼容错误，以下是两种可行的解决方法：

方法一：用`createRequire`兼容CommonJS模块

Node.js内置了createRequire方法，可在ES模块环境中生成一个CommonJS风格的require函数，用于导入mysql模块：

import { createRequire } from 'node:module';
const require = createRequire(import.meta.url);
const mysql = require('mysql');

// 示例：创建数据库连接
const connection = mysql.createConnection({
  host: 'localhost',
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '目标数据库名'
});

connection.connect(err => {
  if (err) throw err;
  console.log('数据库连接成功！');
});

该方法无需修改现有package.json的type配置，保持"type": "module"即可正常使用。

方法二：改用支持ES模块的mysql2包

mysql2是mysql模块的替代实现，API完全兼容，且原生支持ES模块，适合长期维护的项目：

卸载原mysql包：

npm uninstall mysql

安装mysql2：

npm install mysql2

在代码中直接用import导入：

import mysql from 'mysql2';

// 同样方式创建数据库连接
const connection = mysql.createConnection({
  host: 'localhost',
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '目标数据库名'
});

connection.connect(err => {
  if (err) throw err;
  console.log('数据库连接成功！');
});

关于你之前尝试方案无效的说明

若将package.json的type改为commonjs，代码中必须统一使用require而非import，否则会触发模块语法不兼容错误；
修改文件扩展名.cjs/.mjs时，需确保所有相关文件的模块语法与扩展名匹配，比如.cjs文件用require，.mjs文件用import，混合使用会导致模块系统冲突。