OpsKB部署时最常见的问题集中在以下五个方面：
- CSV导入路径错误：
MainServiceImpl中 CSV/JSON 目录默认为开发者本机路径，必须在application.properties中显式覆盖为服务器实际路径，否则/main/loadFromCSV接口会失败。 - ToolController 路径不一致：默认写死为
/opt/neo4j-community-5/import/data.txt，但实际 Neo4j import 目录为/var/lib/neo4j/import，需修改或调用时传filePath。 - APOC 导出失败：后端变更节点后会调用
apoc.export.json.all，需确认 APOC 插件已安装、neo4j.conf已放开相关过程权限、且 Neo4j 对 import 目录有写权限。 - Neo4j 与 ES 数据不同步：两者没有自动同步机制，修改一端不会自动更新另一端，需通过离线脚本重新导入保持一致。
- 前端使用开发模式运行：当前线上仍为 Vite dev server，进程稳定性差，生产环境建议用
npm run build构建后通过 Nginx 托管静态资源。
验证各服务状态可使用 curl http://127.0.0.1:8052/knowledgebase/list、curl http://127.0.0.1:9200 和 systemctl status neo4j。