Node.js 连接 MySQL 为何中文显示乱码报错？

在使用Node.js与MySQL数据库交互时，开发者可能会遇到各种中文报错问题，这些问题通常与字符集、连接配置或查询语句有关，如果不妥善处理，可能会导致数据乱码或程序异常中断，本文将详细分析常见的Node.js MySQL中文报错原因及解决方案,帮助开发者高效排查问题。

字符集配置不当导致乱码

中文报错最常见的原因是数据库连接的字符集设置不正确，默认情况下，MySQL可能使用latin1字符集，而Node.js在处理中文时需要UTF-8编码，若未明确指定字符集，查询结果中的中文可能会显示为问号或乱码，解决方法是创建数据库连接时显式设置charset: 'utf8mb4'，其中utf8mb4是MySQL对UTF-8的完整支持版本，包含emoji和特殊字符。

const connection = mysql.createConnection({  
  host: 'localhost',  
  user: 'root',  
  password: 'password',  
  database: 'test',  
  charset: 'utf8mb4'  
});  

确保数据库表和字段的字符集也设置为utf8mb4，可通过ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4;语句修改。

连接池配置与超时问题

在高并发场景下，未合理配置连接池可能导致连接超时或报错，默认情况下，MySQL连接池的最大连接数可能无法满足需求，引发“Error: Connection lost”或“Too many connections”等中文报错，建议通过以下参数优化连接池：

const pool = mysql.createPool({  
  connectionLimit: 100,  
  host: 'localhost',  
  user: 'username',  
  password: 'password',  
  database: 'dbname',  
  charset: 'utf8mb4',  
  acquireTimeout: 60000  
});  

connectionLimit控制最大连接数，acquireTimeout设置获取连接的超时时间（毫秒），若频繁出现连接丢失，可检查数据库服务是否因资源不足被暂停，或调整wait_timeout参数。

SQL语句语法错误与参数化查询

中文报错也可能源于SQL语句的语法问题，尤其是查询条件中包含中文字符时未正确转义，直接拼接字符串构造SQL语句可能导致语法错误或SQL注入风险，推荐使用参数化查询（Prepared Statements）处理动态条件，

const query = 'SELECT * FROM users WHERE name = ?';  
connection.query(query, ['张三'], (error, results) => {  
  if (error) throw error;  
  console.log(results);  
});  

参数化查询会自动转义特殊字符，避免因中文或特殊符号引发的语法错误，若报错提示“You have an error in your SQL syntax”，需检查表名、字段名是否使用反引号（）包裹，`SELECT * FROM用户表WHERE姓名` = ?“。

驱动版本兼容性问题

不同版本的mysql或mysql2驱动可能与Node.js版本不兼容，导致中文报错，旧版驱动可能不支持utf8mb4字符集或Promise API，建议升级驱动至最新版本，并使用mysql2替代mysql，后者性能更优且支持异步/await语法：

npm install mysql2  

异步查询示例：

(async () => {  
  const connection = await mysql.createConnection(config);  
  const [rows] = await connection.execute('SELECT * FROM products WHERE name = ?', ['中文产品']);  
  console.log(rows);  
})();  

若驱动版本过低，可通过npm outdated检查并更新依赖。

数据库权限与用户配置问题

部分中文报错与数据库用户权限不足有关，用户可能没有执行SELECT、INSERT或ALTER等操作的权限，导致“Access denied”错误，需确保数据库用户拥有目标表的完整权限，可通过以下命令授权：

GRANT ALL PRIVILEGES ON dbname.* TO 'username'@'localhost';  
FLUSH PRIVILEGES;  

检查用户主机配置是否为（允许任意主机）或localhost（仅本地连接）,避免因主机名不匹配导致权限拒绝。

---

相关问答FAQs

Q1：为什么Node.js连接MySQL后查询中文显示为“？？？”？
A1：这通常是由于字符集不匹配导致的，请确保数据库连接、表和字段均使用utf8mb4字符集，并在连接配置中明确指定charset: 'utf8mb4'，同时检查应用程序文件编码是否为UTF-8，避免前端显示时乱码。

Q2：如何解决“Error: ER_ACCESS_DENIED_ERROR: Access denied for user”错误？
A2：该错误表明用户名或密码错误，或用户权限不足，首先核对连接参数中的用户名和密码是否正确；若确认无误，需检查数据库用户是否对目标库拥有操作权限，可通过GRANT语句授权，并确保用户主机配置正确（如'username'@'%'）。