GridDB安装报错：默认端口被占用的排查与解决咨询

1. 识别并停止占用默认端口的进程 #

在WSL环境下，可通过以下命令操作：

• 查找占用10001端口的进程：
  若已安装lsof，执行：

  lsof -i :10001
  

  未安装lsof的话，用ss命令替代：

  ss -tulpn | grep :10001
  

  输出结果里的PID字段就是占用端口的进程ID。
• 停止占用进程：
  直接杀死进程（替换<PID>为实际进程ID）：

  sudo kill -9 <PID>
  

  如果是系统服务类进程，可尝试用服务管理命令停止：

  sudo systemctl stop <服务名>
  

2. 需要检查的端口配置文件 #

GridDB CE 5.1.0版本的核心配置文件如下：

• 集群配置文件：/var/lib/griddb/conf/gs_cluster.json
  重点查看clusterPort字段（默认10001），确认是否与其他服务冲突。
• 节点配置文件：/var/lib/griddb/conf/gs_node.json
  检查servicePort（默认10002）、notificationPort等端口设置，确保无重复占用。
• 环境变量配置文件：/etc/default/griddb
  部分部署会在此文件中定义端口相关的环境变量，需确认是否有自定义端口设置覆盖默认值。

3. 其他需排查的原因 #

• WSL与主机端口冲突：WSL2采用NAT网络，若Windows主机上的进程占用了10001端口，也会导致该报错。需在Windows命令提示符中执行netstat -ano | findstr :10001排查，找到对应PID后在任务管理器中结束进程。
• GridDB残留进程：之前安装或启动失败后，可能有残留的GridDB进程未完全终止，可执行ps aux | grep griddb查找并清理。
• 防火墙拦截：WSL或Windows防火墙可能拦截了10001端口，导致GridDB无法绑定端口，被误判为占用。可临时关闭防火墙测试，或添加GridDB端口的放行规则。
• 权限问题：启动GridDB的用户无端口绑定权限（10001属于非特权端口，但仍需确认用户是否具备足够权限操作相关进程）。

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