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。