首页 / 文档中心 / 常见问题

故障排查

常见错误

错误:数据库连接失败

症状: 页面显示 "数据库连接失败"

  • 解决方案:
  • 检查 data/ 目录权限:chmod 755 data/
  • 确认 neurova.db 文件存在且可写
  • 检查 PHP SQLite 扩展是否安装

错误:无法登录管理后台

症状: 输入正确账号密码后仍无法登录

  • 解决方案:
  • 检查浏览器是否启用 Cookie
  • 检查 Session 目录权限
  • 清除浏览器缓存和 Cookie
  • 检查 logs/ 目录下的错误日志

错误:API返回401未授权

症状: API请求返回 401 Unauthorized

  • 解决方案:
  • 确认 Authorization 头格式正确
  • 检查 API 密钥是否已禁用
  • 确认密钥没有被删除
  • 检查 API 密钥的有效期

性能问题

页面加载缓慢

  • 优化建议:
  • 启用 OPCache
  • 配置 Redis 缓存
  • 使用 CDN 加速静态资源
  • 优化数据库查询

数据库查询慢

  • 优化建议:
  • 添加适当的索引
  • 定期清理旧数据
  • 使用数据库连接池
  • 考虑升级硬件

日志查看

日志位置

  • 应用日志:logs/app.log
  • 访问日志:logs/access.log
  • 错误日志:logs/error.log

查看实时日志

# 查看最近100行错误
tail -n 100 logs/error.log
```
## 联系支持
如果以上方法无法解决问题,请:
1. 查看完整的错误日志
2. 记录复现步骤
3. 访问 GitHub Issues 寻求帮助