OpsKB部署时最常见的问题有哪些，如何排查？

OpsKB部署时最常见的问题集中在以下五个方面：

1. CSV导入路径错误：MainServiceImpl 中 CSV/JSON 目录默认为开发者本机路径，必须在 application.properties 中显式覆盖为服务器实际路径，否则 /main/loadFromCSV 接口会失败。
2. ToolController 路径不一致：默认写死为 /opt/neo4j-community-5/import/data.txt，但实际 Neo4j import 目录为 /var/lib/neo4j/import，需修改或调用时传 filePath。
3. APOC 导出失败：后端变更节点后会调用 apoc.export.json.all，需确认 APOC 插件已安装、neo4j.conf 已放开相关过程权限、且 Neo4j 对 import 目录有写权限。
4. Neo4j 与 ES 数据不同步：两者没有自动同步机制，修改一端不会自动更新另一端，需通过离线脚本重新导入保持一致。
5. 前端使用开发模式运行：当前线上仍为 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。