重点检查Docker Compose状态、端口占用、Nacos访问和磁盘空间；网关与权限问题关注服务注册、JWT校验和角色权限；文件上传问题需检查文件类型、大小限制和MinIO连接配置，避免盲目修改环境或代码，核心排查顺序为：确认请求入口检查服务状态验证配置检查数据库/缓存确认依赖组件查看日志最后修改代码，主要涵盖排障总原则和常见问题解决方案，强调从基础层逐步排查，针对启动问题， ， 文章摘要 本文档为KnowHub RAG平台故障排查指南，。