记一次端口占用导致的 Gateway 启动失败：从 EADDRINUSE 到进程残骸清理

# 使用 ss 命令查看端口占用情况
ss -tlnp | grep 18789

# 使用 lsof 查看占用端口的进程
lsof -i :18789

# 使用 netstat 查看（如果可用）
netstat -tlnp | grep 18789

# 检查所有 openclaw 相关进程
ps aux | grep -E "openclaw|openclaw-gateway" | grep -v grep

# 检查特定 PID（如果从 ss 输出中看到了）
ps -p <PID>

# 检查进程的执行时间（etx 是 elapsed time）
ps -eo pid,etime,cmd | grep openclaw

# 查看所有 openclaw-gateway 相关的 socket
ss -tlnp | grep openclaw

# 查看 TCP 连接状态分布
ss -s

# 查看是否有大量 TIME_WAIT 状态的连接
ss -tan state time-wait | wc -l

# 查看具体端口的 socket 状态
cat /proc/net/tcp | head -5

# 找到占用端口的 socket
ss -tlnp | grep 18789

# 假设输出显示：LISTEN 0 511 *:18789 *:* users:(("openclaw-gatewa",pid=12345,fd=22))

# 使用 ss -K 强制关闭该 socket（需要 root 权限）
ss -K dst 0.0.0.0:18789

# 验证端口是否已释放
ss -tlnp | grep 18789

# 方法1：查看 /proc 文件系统，找到占用端口的 PID
ls -la /proc/*/fd/* 2>/dev/null | grep socket | grep -v grep | head -10

# 方法2：使用 fuser 强制终止占用端口的进程
fuser -k 18789/tcp

# 验证
ss -tlnp | grep 18789

# 重启网络接口（可能会影响其他服务，谨慎使用）
systemctl restart networking

# 或者重启 Docker 服务（如果 Gateway 运行在容器中）
systemctl restart docker

#!/bin/bash
# check-port.sh - Gateway 启动前端口检查

PORT=18789

# 检查端口是否被占用
if ss -tlnp | grep -q ":$PORT "; then
    echo "端口 $PORT 已被占用，尝试清理..."
    
    # 尝试获取占用进程的 PID
    PID=$(ss -tlnp | grep ":$PORT " | grep -oP 'pid=\K[0-9]+')
    
    if [ -n "$PID" ]; then
        echo "正在终止进程 $PID..."
        kill -9 $PID 2>/dev/null
        sleep 2
    fi
    
    # 如果端口仍然被占用，尝试 ss -K
    if ss -tlnp | grep -q ":$PORT "; then
        echo "尝试强制关闭 socket..."
        ss -K dst :$PORT 2>/dev/null
        sleep 2
    fi
fi

# 最终验证
if ss -tlnp | grep -q ":$PORT "; then
    echo "错误：端口 $PORT 仍然被占用，无法启动 Gateway"
    exit 1
else
    echo "端口 $PORT 可用，可以启动 Gateway"
    exit 0
fi

#!/bin/bash
# gateway-port-fix.sh - 端口占用问题排查和修复

PORT=${1:-18789}
LOG_FILE="/tmp/gateway-port-fix.log"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a $LOG_FILE
}

echo "=========================================="
echo "Gateway 端口占用问题修复脚本"
echo "时间：$(date '+%Y-%m-%d %H:%M:%S')"
echo "=========================================="
echo ""

log "开始排查端口 $PORT..."

# 1. 检查端口占用情况
log "[1/6] 检查端口占用情况..."
PORT_STATUS=$(ss -tlnp 2>/dev/null | grep ":$PORT " || echo "")
if [ -z "$PORT_STATUS" ]; then
    log "✅ 端口 $PORT 当前未被占用"
    exit 0
fi

log "发现端口 $PORT 被占用："
echo "$PORT_STATUS"
echo ""

# 2. 提取占用进程的 PID
log "[2/6] 查找占用进程..."
PID=$(echo "$PORT_STATUS" | grep -oP 'pid=\K[0-9]+' | head -1)
if [ -n "$PID" ]; then
    log "占用进程的 PID: $PID"
    
    # 检查进程是否存在
    if ps -p $PID > /dev/null 2>&1; then
        log "进程存在，正在终止..."
        log "进程信息: $(ps -p $PID -o pid,etime,cmd --no-headers)"
        kill -9 $PID
        sleep 3
    else
        log "⚠️ 进程 $PID 不存在（可能是僵死 socket）"
    fi
else
    log "⚠️ 无法获取 PID（可能是内核级别的僵死 socket）"
fi

# 3. 检查端口是否释放
log "[3/6] 检查端口是否释放..."
if ss -tlnp 2>/dev/null | grep -q ":$PORT "; then
    log "⚠️ 端口仍未释放，尝试 ss -K..."
    ss -K dst :$PORT 2>/dev/null
    sleep 3
fi

# 4. 再次检查
log "[4/6] 再次检查端口状态..."
if ss -tlnp 2>/dev/null | grep -q ":$PORT "; then
    log "⚠️ ss -K 也未能释放端口"
    
    # 尝试 fuser
    if command -v fuser &> /dev/null; then
        log "尝试使用 fuser 强制终止..."
        fuser -k $PORT/tcp 2>/dev/null
        sleep 3
    fi
fi

# 5. 最终检查
log "[5/6] 最终检查..."
if ss -tlnp 2>/dev/null | grep -q ":$PORT "; then
    log "❌ 端口 $PORT 仍未释放，需要手动处理"
    log "当前端口状态："
    ss -tlnp | grep ":$PORT "
    exit 1
else
    log "✅ 端口 $PORT 已成功释放"
fi

# 6. 验证 Gateway 可以启动
log "[6/6] 验证 Gateway 状态..."
if systemctl --user is-active openclaw-gateway &>/dev/null; then
    log "✅ Gateway 服务正在运行"
elif systemctl --user is-enabled openclaw-gateway &>/dev/null; then
    log "Gateway 服务已启用但未运行，是否启动？ (y/n)"
    read -r response
    if [ "$response" = "y" ]; then
        systemctl --user start openclaw-gateway
        log "✅ Gateway 服务已启动"
    fi
else
    log "ℹ️  Gateway 服务未启用，无需操作"
fi

echo ""
echo "=========================================="
echo "修复完成！"
echo "=========================================="
echo ""
echo "建议后续操作："
echo "1. 检查 Gateway 服务状态：systemctl --user status openclaw-gateway"
echo "2. 查看 Gateway 日志：journalctl --user-unit openclaw-gateway -n 20"
echo "3. 验证端口绑定：ss -tlnp | grep 18789"
echo ""
echo "日志已保存到：$LOG_FILE"