Gateway 设备令牌不匹配问题排查指南

如果不想重启服务，可以手动触发令牌轮换：

# 查看当前令牌状态
gateway token status

# 强制重新签发
curl -X POST http://127.0.0.1:18789/api/v1/token/rotate \
  -H "Authorization: Bearer $(cat ~/.gateway/.gateway-token)"

# 或者使用 CLI
gateway token rotate --reissue

方案三：排查配置冲突

检查是否存在多个配置文件：

# 查找所有可能的配置文件位置
find ~ -name "gateway.json" 2>/dev/null

# 常见位置：
# ~/.gateway/gateway.json          (用户配置)
# ~/.config/gateway/gateway.json   (XDG 配置)
# /etc/gateway/gateway.json        (系统配置)

# 检查环境变量
env | grep GATEWAY

方案四：Systemd 服务特殊处理

如果使用 systemd 管理 Gateway，需要注意：

# 检查服务配置
cat ~/.config/systemd/user/gateway.service

# 确认环境变量
systemctl --user show gateway --property=Environment

# 重启服务
systemctl --user restart gateway

# 查看详细日志
journalctl --user -u gateway -f

深入理解：Token 机制

Token 存储位置

# 默认位置
~/.gateway/.gateway-token

# 内容示例（JWT 格式）
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token 验证流程

CLI 发起连接 │ ▼ ┌──────────────────┐ │ 1. 读取本地 Token │ │ (~/.gateway/...)│ └────────┬─────────┘ │ ▼ ┌──────────────────┐ │ 2. WebSocket 握手 │ │ 携带 Token │ └────────┬─────────┘ │ ▼ ┌──────────────────┐ │ 3. Gateway 验证 │ │ 对比内存中的 Token│ └────────┬─────────┘ │ ┌────┴────┐ ▼ ▼ 匹配 不匹配 │ │ ▼ ▼ 连接成功 返回 1008 要求重新签发

为什么会 "突然" 出现？

根据代码分析，以下操作可能触发 Token 变更：

1. Gateway 异常退出后自动重启 - 生成新 Token
2. 配置文件被外部工具修改 - 触发重新加载
3. 系统时间变更 - JWT 时间验证失败
4. 并发启动多个实例 - 后启动的覆盖先启动的

预防措施

1. 配置 Systemd 自动重启策略

# ~/.config/systemd/user/gateway.service
[Service]
Type=simple
ExecStart=/usr/bin/node /home/ubuntu/.npm-global/lib/node_modules/gateway/dist/index.js gateway --port 18789
Restart=on-failure
RestartSec=5

# 确保只有一个实例
ExecStartPre=/bin/sh -c 'pgrep -f "gateway" && exit 1 || exit 0'

2. 使用固定 Token（开发环境）

// ~/.gateway/gateway.json
{
  "gateway": {
    "port": 18789,
    "auth": {
      "mode": "static",
      "token": "dev-token-for-local-only"
    }
  }
}

⚠️ 警告：仅用于本地开发，生产环境请使用动态 Token！

3. 监控和告警

#!/bin/bash
# ~/bin/gateway-health-check.sh

if ! gateway status | grep -q "running"; then
  echo "$(date): Gateway 异常，尝试重启..." >> ~/.gateway/health.log
  gateway restart
fi

# 添加到 crontab（每 5 分钟检查）
*/5 * * * * /home/ubuntu/bin/gateway-health-check.sh

调试技巧

启用详细日志

# 设置日志级别
export GATEWAY_LOG_LEVEL=debug

# 重新启动并查看日志
gateway stop
gateway start 2>&1 | tee /tmp/gateway-debug.log

手动验证 Token

# 解码 JWT（需要 jq）
cat ~/.gateway/.gateway-token | cut -d'.' -f2 | base64 -d 2>/dev/null | jq .

# 示例输出：
# {
#   "sub": "gateway-cli",
#   "iat": 1708195200,
#   "exp": 1708789999,
#   "jti": "unique-device-id"
# }

总结

核心要点：

• Token 是 Gateway 与 CLI 之间的信任凭证
• 重启是最简单有效的解决方案
• 生产环境建议配置监控和自动恢复