Strapi安装选PostgreSQL报ECONNREFUSED连接错误解决方法

问题复现场景 #

安装Strapi时未加--quickstart参数（该参数默认使用SQLite数据库，无需额外数据库配置），手动选择PostgreSQL作为项目数据库，操作步骤如下：

• 执行项目创建命令：yarn create strapi-app name-of-my-project
• 安装向导全程选择默认配置：数据库名填strapi、使用默认服务端口、配置常规数据库账号密码、最后一步选择不启用SSL连接
  安装完成后启动服务，会出现指向性模糊的连接错误，报错信息如下：

Connection test failed: connect ECONNREFUSED 127.0.0.1:5433

核心解决方法 #

经2小时排查定位，该报错的根本原因是本地计算机未安装PostgreSQL数据库服务，5433是Strapi预设的PostgreSQL默认连接端口，本地没有对应服务监听该端口就会触发连接拒绝。
解决流程：

1. 在本地完成PostgreSQL数据库的安装与基础初始化配置
2. 进入Strapi项目根目录，执行yarn develop命令即可正常启动服务

同类常见报错处理 #

如果启动时触发SSL相关报错：

Server wasn't able to start properly. Error: The server does not support SSL connections.

问题出在Strapi安装向导的最后一步误选了启用SSL连接，本地部署的PostgreSQL默认未开启SSL支持，重新执行安装流程时在对应步骤选择不启用SSL连接即可修复。

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