连接materialized shell时psql报Connection refused错误如何解决

这个报错本质是当前主机的6875端口没有对应服务响应，属于Materialize服务运行或配置异常导致，可按以下步骤排查解决：

• 检查Materialize服务运行状态
  本地直接部署的场景执行ps aux | grep materialized查看进程是否存活，无运行进程的话，重新执行Materialize启动命令即可。
  Docker部署的场景执行docker ps查看Materialize容器是否处于运行状态，容器停止的话执行docker start <Materialize容器ID/容器名>重新启动即可。
• 核对端口监听配置
  Materialize默认SQL服务端口为6875，可执行ss -tulpn | grep 6875查看端口是否被正常监听。如果无监听结果，检查启动参数中--sql-port配置是否被修改为其他端口，调整后重新启动服务即可。
• 排查本地网络限制
  检查本地防火墙、iptables规则是否拦截了6875端口的TCP连接，可临时关闭防火墙测试连接是否恢复，确认是拦截问题后添加6875端口的放行规则即可。
• 核对远程连接参数
  若连接的是远程部署的Materialize实例，需将连接命令中的主机地址从localhost替换为实际部署服务器的IP，同时确认服务器侧的安全组、防火墙已放行6875端口的访问请求。

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