Node.js与MySQL连接失败求助：PHP可正常连接（默认3306端口）

嘿，我来帮你排查这个Node.js连接MySQL的问题～既然PHP能正常连接，说明MySQL服务本身、端口3306都是没问题的，咱们从Node.js端的配置和细节入手：

可能的排查方向及解决方案 #

1. 确认MySQL驱动是否正确安装且版本适配 #

你当前用的是mysql模块，这个模块现在维护频率较低，很多开发者转用mysql2（兼容性更好，支持Promise等特性）。先试试重新安装或切换驱动：

• 安装mysql2：

  npm install mysql2
  

• 代码里替换引入：

  const mysql = require('mysql2'); // 替换原来的require('mysql')
  

2. 补全连接配置的必填项 #

你的代码里缺少数据库名称的配置，PHP可能默认使用了某个数据库，但Node.js需要明确指定。另外可以显式声明端口（虽然是默认3306，但避免环境变量干扰）：

var connection = mysql.createConnection({
  host: 'localhost', // 或者尝试'127.0.0.1'，避免IPv6解析问题
  user: 'root',
  password: 'root',
  database: 'your_php_used_database', // 替换成PHP连接时用的数据库名
  port: 3306
});

3. 完善错误和成功日志，获取完整信息 #

你的代码里成功日志没写完，而且错误日志可以更详细，方便定位问题：

connection.connect(function(err) {
  if (err) {
    console.error('连接失败详情:', err); // 打印完整错误对象，包含错误码、信息等
    return;
  }
  console.log('连接成功，线程ID:', connection.threadId); // 补全成功日志
});

比如如果是ER_BAD_DB_ERROR就是数据库不存在，ER_ACCESS_DENIED_ERROR就是权限问题，通过完整错误信息能快速定位。

4. 确认MySQL用户的连接权限 #

虽然PHP能用，但可以确认下root用户是否允许从localhost连接：
登录MySQL执行以下命令：

SELECT user, host FROM mysql.user WHERE user='root';

如果root的host是localhost或%（允许任意地址）就没问题，如果是其他值，需要修改权限：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'root';
FLUSH PRIVILEGES;

5. 尝试用127.0.0.1代替localhost #

有些系统中localhost会优先解析到IPv6的::1，但如果MySQL只监听了IPv4的127.0.0.1，就会连接失败。把host改成127.0.0.1试试。

完整测试代码 #

这里给你一个完整的可运行测试代码（用mysql2）：

const mysql = require('mysql2');

const connection = mysql.createConnection({
  host: '127.0.0.1',
  user: 'root',
  password: 'root',
  database: 'test', // 替换成你的数据库名
  port: 3306
});

connection.connect((err) => {
  if (err) {
    console.error('连接失败:', err);
    return;
  }
  console.log('成功连接到MySQL！线程ID:', connection.threadId);
  // 测试查询
  connection.query('SELECT 1 + 1 AS solution', (err, results) => {
    if (err) throw err;
    console.log('查询结果:', results[0].solution);
    connection.end(); // 关闭连接
  });
});

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