You need to enable JavaScript to run this app. Node.js v6.11.2 使用mysql2连接池配置SSL加密连接遇解密错误问题
优惠活动
大模型
产品
解决方案
定价
更多

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 error
error: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服务端的交互规范
正确配置实现步骤
  1. 修正证书读取逻辑,明确指定utf8编码读取PEM格式证书,避免Buffer兼容问题
  2. 在SSL配置块中强制指定最低TLS版本为TLSv1.2,关闭旧TLS版本降级协商能力
  3. 确认运行Node进程的用户对证书文件有读取权限,证书文件保留完整的PEM格式头尾标识
  4. 匹配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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 09:06:03