Next.js项目中Prisma无法连接AWS RDS数据库求助

按优先级逐一排查：

1. 测试本地到RDS的网络连通性 #

先确认本地机器能否访问RDS的5432端口，执行以下命令：

# 用telnet测试
telnet db-name.*.us-west-2.rds.amazonaws.com 5432
# 或用nc（部分系统默认安装）
nc -zv db-name.*.us-west-2.rds.amazonaws.com 5432

如果连接失败，重点检查：

• AWS RDS安全组的入站规则：添加你的本地公网IP（可通过搜索引擎查询），允许5432端口的PostgreSQL流量（不要直接开放0.0.0.0/0，先测试自身IP）
• 本地防火墙/杀毒软件：是否拦截了出站的5432端口请求

2. 校验DATABASE_URL的正确性 #

确保环境变量DATABASE_URL格式完全合规：

• 若用户名/密码包含特殊字符（如@、%、&），必须进行URL编码（例如@替换为%40）
• 末尾的数据库名称需与RDS实例中创建的库名完全一致
• 可临时将schema.prisma中的url改为硬编码的测试地址（测试完成后改回环境变量，避免泄露凭证）：

  url    = "postgresql://master_username:master_password@aws_host:5432/db_name"
  

3. 确认RDS实例状态与配置 #

登录AWS控制台检查RDS实例：

• 实例状态是否为available（创建中/重启中的实例无法连接）
• 复制的Endpoint地址是否完全正确（注意不要包含多余空格或遗漏字符）

4. 验证数据库用户权限与直接连接 #

用psql客户端直接尝试连接RDS，排查是否为Prisma配置问题：

psql postgresql://master_username:master_password@db-name.*.us-west-2.rds.amazonaws.com:5432/db_name

如果psql连接失败，说明是数据库端问题：

• 检查数据库用户是否被授权从当前IP访问（RDS默认用户权限为master_username@%，但需确认未被修改）
• 再次核对用户名与密码是否正确

5. 检查Prisma与PostgreSQL版本兼容性 #

确认Prisma版本与RDS上PostgreSQL版本兼容，部分旧版Prisma可能不支持最新的PostgreSQL大版本，可查看Prisma官方兼容性说明调整版本。

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