Node.js部署在Heroku连接ClearDB使用createPool出现Access denied错误

问题根因排查 #

• 参数拆分错误：ClearDB生成的数据库连接URL中，密码大概率包含@、/、?这类URL保留字符，按固定规则手动拆分很容易出现密码截断、主机地址识别错误的问题，最终导致认证失败。
• 连接数配置超标：ClearDB免费版实例的最大连接数通常只有10个，你配置的connectionLimit: 100远超实例限制，也会触发连接拒绝类错误。
• 环境变量配置错误：拆分后自定义的HOST/USER/PWD/DB环境变量可能未在Heroku后台正确配置，或者赋值时参数混淆，导致传入的认证信息不匹配。

解决方法 #

方案1（最简便，推荐）：直接传入连接URL创建连接池 #

mysql模块的createPool方法本身支持直接传入完整连接字符串，无需手动拆分参数，代码如下：

let pool = mysql.createPool(process.env.CLEARDB_DATABASE_URL);

该方法会自动解析URL中的所有参数，包括特殊字符转义，完全避免手动拆分的错误。

方案2：使用工具模块解析URL（如果需要自定义额外参数） #

如果需要额外配置连接池参数，不要手动拆分URL，使用Node.js内置的url模块完成解析，自动处理特殊字符：

const url = require('url');
const dbConnUrl = url.parse(process.env.CLEARDB_DATABASE_URL);

let pool = mysql.createPool({
    connectionLimit: 10, // 匹配ClearDB实例的连接数上限
    host: dbConnUrl.hostname,
    user: dbConnUrl.auth.split(':')[0],
    password: dbConnUrl.auth.split(':')[1],
    database: dbConnUrl.pathname.slice(1),
    ssl: { rejectUnauthorized: false } // 兼容ClearDB的SSL连接要求
});

内容的提问来源于stack exchange，提问作者Jeffrey Carr