Sequelize连接Amazon RDS PostgreSQL报数据库不存在问题求助

核心问题诱因 #

最高发的触发原因是混淆了两个独立的AWS资源标识：

• database-1 是你在AWS上创建的RDS DB实例的标识符，属于AWS层面的实例命名，不是PostgreSQL引擎内部的数据库实体名称
• 只有PostgreSQL实例内部实际创建的数据库，才是Sequelize连接配置里需要填写的database参数值

分步排查与修复 #

• 核对RDS实例内的实际数据库名称
  进入AWS控制台对应RDS实例的详情页，在配置信息板块找到「初始数据库名称」字段：
  • 如果创建实例时手动指定了数据库名，该字段值就是可直接连接的默认数据库
  • 如果创建时该字段留空，RDS会自动创建名为postgres的默认数据库，不会自动创建和实例标识符同名的数据库
    把该字段的实际值替换到Sequelize配置的database参数中，替代之前误填的实例名database-1。
• 校验Sequelize配置的实际生效值
  排除环境变量配置正确但被代码覆盖的情况：
  • 检查Sequelize实例初始化代码，确认没有硬编码的database值、没有高优先级的本地配置文件覆盖环境变量的取值
  • 在连接初始化逻辑中临时打印实际传入Sequelize的database参数值，确认实际读取的值和预期的RDS数据库名一致，没有残留旧的database-1配置
• 验证实例内的数据库真实存在性
  通过RDS主账号使用psql工具连接到实例默认的postgres库，执行\l元命令列出所有实例内的数据库清单，确认目标数据库已被创建、没有被误删除。
• 排查权限类的伪报错
  PostgreSQL为了避免数据库枚举泄露，当连接账号对目标数据库没有CONNECT权限时，会统一返回“数据库不存在”的报错，而非权限不足的提示。此时需要给连接使用的账号授予对应目标数据库的连接权限，即可解决该类伪报错。
• 检查连接串格式问题
  如果使用URI格式配置Sequelize连接，确认连接串的路径部分填写的是实际数据库名，格式符合postgres://[账号]:[密码]@[RDS端点]:5432/[实际数据库名]的规范，避免漏写数据库名导致Sequelize默认尝试连接系统用户同名数据库触发报错。

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