使用Sequelize/NodeJS连接Heroku PostgreSQL数据库失败，疑似sslmode配置异常

我之前在Heroku和DigitalOcean上部署Node.js+Sequelize应用时，也碰到过一模一样的问题！这个错误的核心原因是Sequelize并没有自动从你的DATABASE_URL里识别并启用SSL配置，哪怕你已经加了sslmode=require参数。下面是几个亲测有效的解决方法：

1. 手动解析数据库URL并强制配置SSL #

直接让Sequelize读取DATABASE_URL时，它经常会忽略sslmode参数，所以我们需要手动解析URL，然后在Sequelize配置里明确指定SSL选项。Node.js自带的url模块就能完成解析，代码示例如下：

const { URL } = require('url');
const { Sequelize } = require('sequelize');

// 解析环境变量中的数据库URL
const dbUrl = new URL(process.env.DATABASE_URL);

// 初始化Sequelize实例，手动配置SSL
const sequelize = new Sequelize(
  dbUrl.pathname.slice(1), // 提取数据库名（去掉开头的/）
  dbUrl.username,
  dbUrl.password,
  {
    host: dbUrl.hostname,
    port: dbUrl.port,
    dialect: 'postgres',
    dialectOptions: {
      ssl: {
        require: true, // 强制要求SSL连接
        rejectUnauthorized: false // 关键！Heroku/DO的PostgreSQL需要关闭证书验证，否则会报错
      }
    }
  }
);

为什么要设置rejectUnauthorized: false？因为Heroku和DigitalOcean的PostgreSQL服务使用的是自签名证书或者内部CA颁发的证书，客户端默认的证书验证会失败，关闭这个选项就能正常连接了。

2. 升级Sequelize到最新稳定版 #

如果你使用的是较旧版本的Sequelize（比如v5及以下），它对PostgreSQL连接字符串中的sslmode参数支持不完善。建议升级到v6及以上版本，新版本对URL参数的解析更准确，有时候甚至不需要手动配置SSL就能正常连接。

升级命令：

npm install sequelize@latest

3. 确认环境变量正确加载 #

有时候问题出在环境变量没有被正确读取，建议在初始化Sequelize之前加一行日志，确认DATABASE_URL确实包含sslmode=require：

console.log('当前数据库URL:', process.env.DATABASE_URL);

如果输出的URL里没有这个参数，说明托管平台没有正确填充环境变量，你需要检查Heroku/DO的数据库配置页面，确认是否开启了SSL强制选项。

4. 针对Heroku的额外提示 #

Heroku官方文档明确提到，连接他们的PostgreSQL服务时，必须设置rejectUnauthorized: false，因为Heroku会自动管理证书，不需要客户端进行验证。如果不设置这个选项，即使你启用了SSL，也会因为证书验证失败而无法连接。

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