故障排除

解决常见问题和错误

快速诊断

首先检查以下基本项：

Text
□ API 服务是否运行？
□ 数据库是否连接？
□ 网络是否通畅？
□ Token 是否有效？

常见错误

1. 连接错误

症状: 无法连接到 API

检查:

Bash
# 测试 API 是否响应
curl http://localhost:5030/

# 应该返回: {"status": "running"}

解决方案:

检查服务是否启动

检查端口是否正确

检查防火墙规则

2. 认证失败

症状: {"error": "Auth failed"}

检查:

Bash
# 确认 Key 哈希正确
echo -n "your_key" | sha256sum

解决方案:

确认配置文件中的 Key

重新计算 SHA256 哈希

检查请求格式

3. Token 无效

症状: {"error": "Token not found"}

解决方案:

Bash
# 查询 Token 列表
curl "http://localhost:5030/token/list?mail=your@email.com&key=$KEY_HASH"

确认 Token 正确

重新创建 Token

检查 Token 格式

4. 权限不足

症状: {"error": "No permission"}

解决方案:

Bash
# 授予上传权限
curl -X POST http://localhost:5030/token/permission/add \
  -H "Content-Type: application/json" \
  -d '{"token": "your_token", "key": "$KEY_HASH"}'

5. 数据库错误

症状: 数据库相关错误

检查:

Bash
# 测试数据库连接
mysql -u user -p -e "SELECT 1"

解决方案:

检查 config/sql_config.json

确认数据库存在

检查用户权限

日志分析

日志位置

日志文件	说明
`logs/core.log`	核心日志
`logs/mysql.log`	数据库日志
`logs/ndpv1.log`	v1 兼容日志

日志级别

INFO: 一般信息

WARN: 警告

ERROR: 错误

DEBUG: 调试

性能问题

API 响应慢

检查数据库查询性能

启用缓存

优化网络

内存占用高

检查是否有内存泄漏

限制连接数

重启服务

调试技巧

启用调试日志

编辑 config/core_config.json:

JSON
{
    "logging": {
        "level": "DEBUG"
    }
}

测试 API 调用

Bash
# 健康检查
curl http://localhost:5030/

# 创建 Token
curl -X POST http://localhost:5030/token/get \
  -H "Content-Type: application/json" \
  -d '{"uuid":"test","mail":"test@test.com","key":"hash"}'

# 添加封禁
curl -X POST http://localhost:5030/bans/add \
  -H "Content-Type: application/json" \
  -d '{"token":"your_token","player_id":"test"}'

获取帮助

如果以上方法无法解决问题：

收集日志信息

记录复现步骤

联系支持团队

报告问题时，请提供：<br>

1. 完整的错误信息<br>

2. 相关的日志内容<br>

3. 复现步骤

</div>