Node.js v6.11.2 使用mysql2连接池配置SSL加密连接遇解密错误问题
运行环境与原有基础实现
- 版本环境:Node.js v6.11.2,使用
mysql2模块实现数据库连接池 - 原有无SSL的连接池实现代码:
const mysql = require('mysql2'); const cpmPoolConfig = { connectionLimit: config.get('mysql_cpm.connectionLimit'), host: config.get('mysql_cpm.host'), port: config.get('mysql_cpm.port'), user: config.get('mysql_cpm.user'), password: config.get('mysql_cpm.password'), database: config.get('mysql_cpm.database'), debug: config.get('mysql_cpm.debug'), } const poolCpm = mysql.createPool(cpmPoolConfig); var getConnectionCpm = function () { return getConnectionWithRetry(poolCpm).disposer(function (connection) { serverLOG.debug('Releasing db connection.'); connection.release(); }); }
现有尝试的SSL配置与报错现象
为实现SSL加密连接,在原有配置基础上追加了证书加载逻辑,配置代码如下:
const fs = require('fs'); const cpmPoolConfig = { connectionLimit: config.get('mysql_cpm.connectionLimit'), host: config.get('mysql_cpm.host'), port: config.get('mysql_cpm.port'), user: config.get('mysql_cpm.user'), password: encryptionUtil.decrypt(config.get('mysql_cpm.password')), database: config.get('mysql_cpm.database'), debug: config.get('mysql_cpm.debug'), ssl: { ca: fs.readFileSync('/data/celo/dbcerts/ca.pem'), cert: fs.readFileSync('/data/celo/dbcerts/client-cert.pem'), key: fs.readFileSync('/data/celo/dbcerts/client-key.pem') } }
配置生效后获取数据库连接时抛出SSL握手错误,核心报错信息为:
error:1409441B:SSL routines:ssl3_read_bytes:tlsv1 alert decrypt errorerror:140940E5:SSL routines:ssl3_read_bytes:ssl handshake failure
报错核心原因排查
结合Node v6.11.2与对应兼容版mysql2的运行特性,该类解密错误、握手失败的问题通常由以下几点触发:
- Node v6.11.2内置OpenSSL默认允许TLS版本降级协商,若MySQL服务端强制要求TLS 1.2及以上版本,版本协商不匹配会直接触发解密告警
fs.readFileSync未指定编码时默认返回Buffer对象,旧版mysql2对Buffer格式的证书内容存在兼容问题,无法正确解析证书完成密钥交换- 证书文件存在格式损坏、权限不足、和服务端要求的客户端证书/密钥不匹配
- 缺少TLS连接必要的校验配置,导致SSL握手流程不符合MySQL服务端的交互规范
正确配置实现步骤
- 修正证书读取逻辑,明确指定
utf8编码读取PEM格式证书,避免Buffer兼容问题 - 在SSL配置块中强制指定最低TLS版本为
TLSv1.2,关闭旧TLS版本降级协商能力 - 确认运行Node进程的用户对证书文件有读取权限,证书文件保留完整的PEM格式头尾标识
- 匹配MySQL服务端的SSL认证要求:若服务端仅要求加密连接、通过CA校验服务端身份,可简化移除客户端证书/私钥配置;若服务端开启了X509强制校验客户端身份,再保留对应客户端证书、密钥配置
修正后的完整可运行配置如下:
const fs = require('fs'); const cpmPoolConfig = { connectionLimit: config.get('mysql_cpm.connectionLimit'), host: config.get('mysql_cpm.host'), port: config.get('mysql_cpm.port'), user: config.get('mysql_cpm.user'), password: encryptionUtil.decrypt(config.get('mysql_cpm.password')), database: config.get('mysql_cpm.database'), debug: config.get('mysql_cpm.debug'), ssl: { // 明确指定utf8编码读取证书,兼容旧版mysql2解析逻辑 ca: fs.readFileSync('/data/celo/dbcerts/ca.pem', 'utf8'), cert: fs.readFileSync('/data/celo/dbcerts/client-cert.pem', 'utf8'), key: fs.readFileSync('/data/celo/dbcerts/client-key.pem', 'utf8'), // 强制最低TLS版本为1.2,避免版本降级协商失败 minVersion: 'TLSv1.2', // 开启合法证书校验,符合服务端SSL交互规范 rejectUnauthorized: true } } // 原有连接池初始化、连接获取逻辑无需调整 const poolCpm = mysql.createPool(cpmPoolConfig); var getConnectionCpm = function () { return getConnectionWithRetry(poolCpm).disposer(function (connection) { serverLOG.debug('Releasing db connection.'); connection.release(); }); }
排查辅助方法:可先通过mysql命令行工具传入相同证书测试连通性,若命令行可正常连接、Node端报错,可直接对比两边的配置差异定位问题,无需反复调整代码。
内容的提问来源于stack exchange,提问作者shekhar
相关产品推荐
相关产品推荐

