🚀 快速诊断
如果 API 调用返回错误，请按照以下步骤进行排查。
检查服务健康状态
首先确认 API 服务本身是否正常运行。curl https://api.dev.akria.net/api/v1/health
验证 API Key 是否有效
尝试发送一个简单的测试信号。curl -X POST https://api.dev.akria.net/api/v1/signals \
-H "X-API-Key: your-api-key" \
-d '{"title": "Test", "priority": "low", ...}'
🔍 常见错误排查
401 Unauthorized - Invalid API Key
可能原因：
- Key 填写错误（检查是否有空格）
- Key 已被禁用或删除
- 数据库哈希值不匹配
解决方法：使用管理脚本 python scripts/manage_api_keys.py list 确认 Key 状态。 401 Unauthorized - Missing API Key
可能原因：
- 未在 Header 中包含
X-API-Key
- Header 名称拼写错误
解决方法：确保 Header 格式为 X-API-Key: <your_key>。
可能原因：解决方法：联系管理员续期或更换新 Key。
📊 使用统计查看
SELECT group_name, SUM(usage_count) FROM api_keys GROUP BY group_name;
-- 查找使用次数异常高的 Key
SELECT id, key_name, usage_count FROM api_keys ORDER BY usage_count DESC LIMIT 10;
详细的日志分析请查看服务器日志：kubectl logs -l app=insight-core-api-dev -n insight-dev
