查看端口占用情况

OpenClaw网关启动失败可能由多种原因引起,以下是一个系统性的排查和解决方案：

常见问题及解决方法

端口冲突

# 或使用 lsof
lsof -i :8080
# 解决方案：
# a. 杀死占用进程
kill -9 PID
# b. 修改配置文件中的端口
# 在 application.yml 中修改：
# server.port: 新端口

配置文件错误

# 检查关键配置：
spring:
  application:
    name: openclaw-gateway
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848  # 确认Nacos地址
    gateway:
      routes:
        - id: xxx
          uri: lb://service-name  # 确认服务名正确

依赖服务未启动

# 检查依赖的服务是否运行：
# Nacos、Redis、MySQL等
systemctl status nacos
systemctl status redis
# 确认网络连接
ping 服务地址
telnet 服务地址 端口

内存不足

# 查看内存使用
free -h
# 调整JVM参数
java -Xms512m -Xmx1024m -jar openclaw-gateway.jar

详细排查步骤

步骤1：查看日志

# 查看启动日志
tail -f logs/openclaw-gateway.log
# 或查看控制台输出
journalctl -u openclaw-gateway -f

步骤2：常见错误及修复

错误1：数据库连接失败

Caused by: java.net.ConnectException: Connection refused

解决：

1. 检查数据库服务是否启动
2. 确认数据库连接参数正确
3. 检查网络防火墙设置

错误2：Nacos连接失败

com.alibaba.nacos.api.exception.NacosException: failed to req API

解决：

# 检查Nacos
curl http://localhost:8848/nacos/
# 确认配置文件中Nacos地址正确

错误3：证书或SSL问题

javax.net.ssl.SSLException

解决：

# 在配置中禁用SSL验证（仅测试环境）
spring:
  cloud:
    gateway:
      httpclient:
        ssl:
          useInsecureTrustManager: true

步骤3：环境检查脚本

#!/bin/bash
# check_env.sh
echo "=== OpenClaw网关环境检查 ==="
# 1. 检查Java版本
echo "Java版本："
java -version
# 2. 检查端口占用
echo -e "\n端口占用检查："
PORTS=(8080 8848 6379 3306)
for port in ${PORTS[@]}; do
    echo "端口 $port:"
    lsof -i :$port || echo "未占用"
done
# 3. 检查服务状态
echo -e "\n服务状态："
services=("nacos" "redis" "mysql")
for svc in ${services[@]}; do
    if systemctl is-active --quiet $svc; then
        echo "$svc: 运行中"
    else
        echo "$svc: 未运行"
    fi
done
# 4. 检查配置文件
echo -e "\n配置文件检查："
if [ -f "application.yml" ]; then
    echo "application.yml 存在"
    grep -n "server.port\|nacos\|redis" application.yml
else
    echo "配置文件不存在"
fi

启动命令示例

Docker启动：

# 清理旧容器
docker rm -f openclaw-gateway
# 启动新容器
docker run -d \
  --name openclaw-gateway \
  -p 8080:8080 \
  -v ./config:/config \
  -e JAVA_OPTS="-Xmx512m" \
  openclaw/gateway:latest

系统服务启动（Systemd）：

# /etc/systemd/system/openclaw-gateway.service
[Unit]
Description=OpenClaw Gateway Service
After=network.target nacos.service
[Service]
Type=simple
ExecStart=/usr/bin/java -jar /opt/openclaw/openclaw-gateway.jar
User=openclaw
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target

# 启用服务
systemctl daemon-reload
systemctl enable openclaw-gateway
systemctl start openclaw-gateway

高级调试

开启详细日志

# application.yml
logging:
  level:
    org.springframework.cloud.gateway: DEBUG
    reactor.netty: DEBUG
    com.alibaba.nacos: DEBUG

使用Arthas诊断

# 安装Arthas
curl -L https://arthas.aliyun.com/arthas-boot.jar -o arthas-boot.jar
# 附加到网关进程
java -jar arthas-boot.jar
# 常用命令
dashboard    # 查看系统状态
thread       # 查看线程
watch        # 监控方法调用

健康检查端点

# 如果网关启动但无法路由，检查健康状态
curl http://localhost:8080/actuator/health
curl http://localhost:8080/actuator/gateway/routes

快速恢复方案

如果问题紧急,可以尝试：

1. 回滚到上一个版本
2. 使用备份配置
3. 重启所有依赖服务
4. 清理临时文件

   rm -rf logs/*
   rm -rf temp/*

预防措施

1. 使用配置中心：将配置统一管理
2. 设置监控告警：监控网关关键指标
3. 定期备份配置
4. 测试环境先行：在测试环境验证后再上线

请根据具体的错误日志选择对应的解决方案,如果问题仍然存在，请提供更详细的错误信息，我可以给出更针对性的建议。

标签： netstat 端口占用