使用PostgreSQL安装Strapi报ECONNREFUSED 127.0.0.1:5433错误如何解决

错误含义 #

Connection test failed: connect ECONNREFUSED 127.0.0.1:5433 表示Strapi在初始化时尝试连接本地5433端口的PostgreSQL服务时，请求被拒绝，没有获得服务响应。

修复步骤 #

• 第一步：确认PostgreSQL服务正常运行

  • Windows系统：打开服务管理器，查找对应版本的PostgreSQL服务（命名格式为postgresql-x64-<版本号>），确认状态为「正在运行」，未运行则手动启动服务。
  • Linux系统：执行命令 sudo systemctl status postgresql 查看运行状态，未运行则执行 sudo systemctl start postgresql 启动。
  • macOS系统：若为brew安装，执行 brew services list 查看postgresql状态，未运行则执行 brew services start postgresql 启动。

• 第二步：核对PostgreSQL实际监听端口
  PostgreSQL默认端口为5432，报错指向的5433为非默认端口，大概率是配置填写错误或PostgreSQL配置了自定义端口：

  1. 查找PostgreSQL配置文件postgresql.conf，查看port参数的实际取值
  2. 也可以执行端口扫描命令直接确认：
     • Linux/macOS执行：netstat -an | grep LISTEN | grep postgres
     • Windows执行：netstat -ano | findstr postgres
  3. 后续在Strapi初始化的数据库配置步骤，端口字段填写实际的监听端口即可。

• 第三步：确认本地TCP连接权限
  打开PostgreSQL的pg_hba.conf配置文件，确认存在允许本地回环地址访问的规则：

  host all all 127.0.0.1/32 scram-sha-256
  无该规则则手动添加后，重启PostgreSQL服务生效。

• 第四步：测试数据库连接有效性
  Strapi初始化需要你提前在PostgreSQL中创建好空的目标数据库，且填写的账号密码有该库的访问权限。你可以先通过psql命令测试连接是否正常：

  psql -h 127.0.0.1 -p <你的PostgreSQL端口> -U <数据库用户名> <目标数据库名>
  

  该命令能正常登录的情况下，再重新执行yarn create strapi-app my-project命令即可。

• 第五步：排查防火墙拦截
  若以上步骤都无问题，检查本地防火墙规则，确认PostgreSQL监听的端口没有被拦截，本地回环地址的连接规则为允许。

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