apisix/ssl_manager/DASHBOARD_TROUBLESHOOT.md

Dashboard 看不到路由和证书的排查指南

问题现象

测试脚本成功创建了路由和证书，但在 Dashboard 面板中看不到。

验证数据确实存在

通过 Admin API 验证

# 检查路由
curl -s http://localhost:9180/apisix/admin/routes/test.jingrowtools.cn \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137'

# 检查 SSL
curl -s http://localhost:9180/apisix/admin/ssls/00000000000000000023 \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137'

通过 etcd 验证

# 检查路由
docker exec apisix-etcd-1 etcdctl get /apisix/routes/test.jingrowtools.cn

# 检查 SSL
docker exec apisix-etcd-1 etcdctl get /apisix/ssls/00000000000000000023

可能的原因和解决方案

1. Dashboard 缓存问题 ⚠️ 最常见

原因： Dashboard 可能缓存了数据，没有实时刷新。

解决方案：

• 刷新浏览器页面（F5 或 Ctrl+R）
• 清除浏览器缓存（Ctrl+Shift+Delete）
• 硬刷新（Ctrl+Shift+R 或 Ctrl+F5）
• 等待几秒钟后再次查看（Dashboard 可能有轮询间隔）

2. Dashboard 过滤条件

原因： Dashboard 可能设置了过滤条件，隐藏了某些路由。

解决方案：

• 检查 Dashboard 的搜索/过滤框，确保没有输入过滤条件
• 检查路由列表的显示选项（如：显示所有、只显示启用的等）
• 尝试搜索 test.jingrowtools.cn 看是否能找到

3. Dashboard 连接问题

原因： Dashboard 可能连接到了不同的 etcd 实例。

检查方法：

# 检查 Dashboard 日志
docker logs apisix-dashboard --tail 50 | grep -i etcd

# 检查 Dashboard 配置
cat /home/jingrow/apisix/dashboard_conf/conf.yaml

解决方案：

• 确保 Dashboard 配置的 etcd 地址正确
• 重启 Dashboard：docker restart apisix-dashboard

4. 路由/证书状态问题

原因： Dashboard 可能只显示特定状态的路由/证书。

检查方法：

# 检查路由状态
curl -s http://localhost:9180/apisix/admin/routes/test.jingrowtools.cn \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; print(json.load(sys.stdin)['value']['status'])"

# 检查 SSL 状态
curl -s http://localhost:9180/apisix/admin/ssls/00000000000000000023 \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; print(json.load(sys.stdin)['value']['status'])"

解决方案：

• 确保 status: 1（启用状态）
• 如果状态为 0，需要启用

5. Dashboard 版本兼容性问题

原因： Dashboard 版本可能与 APISIX 版本不兼容。

检查方法：

# 检查 Dashboard 版本
docker exec apisix-dashboard cat /usr/local/apisix-dashboard/version 2>/dev/null || \
  docker exec apisix-dashboard ls /usr/local/apisix-dashboard/

# 检查 APISIX 版本
docker exec apisix-apisix-1 apisix version

6. 权限问题

原因： Dashboard 用户可能没有查看权限。

解决方案：

• 检查 Dashboard 登录用户权限
• 尝试使用管理员账户登录

快速排查步骤

步骤 1: 验证数据存在

# 检查路由是否存在
curl -s http://localhost:9180/apisix/admin/routes \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; routes=json.load(sys.stdin)['list']; \
  test=[r for r in routes if 'test.jingrowtools.cn' in str(r.get('value', {}).get('name', ''))]; \
  print(f'找到测试路由: {len(test)} 个')"

# 检查 SSL 是否存在
curl -s http://localhost:9180/apisix/admin/ssls \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; ssls=json.load(sys.stdin)['list']; \
  test=[s for s in ssls if 'test.jingrowtools.cn' in str(s.get('value', {}).get('snis', []))]; \
  print(f'找到测试 SSL: {len(test)} 个')"

步骤 2: 刷新 Dashboard

1. 在浏览器中按 Ctrl+Shift+R 硬刷新
2. 等待 5-10 秒
3. 再次查看路由和 SSL 列表

步骤 3: 检查 Dashboard 连接

# 重启 Dashboard
docker restart apisix-dashboard

# 等待启动
sleep 5

# 检查日志
docker logs apisix-dashboard --tail 20

步骤 4: 直接通过 Dashboard API 查询

# 访问 Dashboard API（需要登录 token）
# 在浏览器中打开开发者工具（F12），查看 Network 请求
# 找到 Dashboard API 的请求，查看返回的数据

常见解决方案

方案 1: 强制刷新（最简单）

1. 打开 Dashboard
2. 按 Ctrl+Shift+R 硬刷新
3. 等待几秒钟
4. 再次查看

方案 2: 重启 Dashboard

docker restart apisix-dashboard

等待 10 秒后刷新浏览器。

方案 3: 检查路由状态

如果路由状态为 0（禁用），需要启用：

# 启用路由
curl -X PUT http://localhost:9180/apisix/admin/routes/test.jingrowtools.cn \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' \
  -H 'Content-Type: application/json' \
  -d '{
    "uri": "/*",
    "name": "test.jingrowtools.cn",
    "host": "test.jingrowtools.cn",
    "status": 1,
    ...
  }'

验证脚本

创建一个验证脚本检查 Dashboard 是否能访问数据：

#!/bin/bash
# 验证 Dashboard 数据访问

echo "检查路由..."
curl -s http://localhost:9180/apisix/admin/routes \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; data=json.load(sys.stdin); \
  print(f'总路由数: {len(data[\"list\"])}'); \
  test=[r for r in data['list'] if 'test' in str(r.get('value', {}).get('name', ''))]; \
  print(f'测试路由数: {len(test)}')"

echo ""
echo "检查 SSL..."
curl -s http://localhost:9180/apisix/admin/ssls \
  -H 'X-API-KEY: 8206e6e42b6b53243c52a767cc633137' | \
  python3 -c "import sys, json; data=json.load(sys.stdin); \
  print(f'总 SSL 数: {len(data[\"list\"])}'); \
  test=[s for s in data['list'] if 'test' in str(s.get('value', {}).get('snis', []))]; \
  print(f'测试 SSL 数: {len(test)}')"

总结

最可能的原因：

1. ✅ Dashboard 缓存 - 需要刷新浏览器
2. ✅ Dashboard 过滤条件 - 检查搜索框
3. ✅ 数据状态 - 确保 status=1

快速解决：

1. 硬刷新浏览器（Ctrl+Shift+R）
2. 等待 5-10 秒
3. 检查搜索/过滤条件
4. 如果还不行，重启 Dashboard