首次使用ArangoDB创建图时出现Illegal Document Key错误求助

ArangoDB illegal document key 报错排查方案 #

• 优先检查顶点/边集合的命名合规性：ArangoDB 自动生成的文档key本身符合规范，该报错多数是因为集合名称包含空格、斜杠、中文、特殊符号，系统拼接集合名/文档key格式的完整文档ID时，触发了非法key校验。你可以先确认所有涉及的集合名称仅包含字母、数字、下划线、横杠，且开头不是数字。
• 核查集合的key生成配置：如果创建集合时修改了keyOptions参数但配置有误，即使选择系统自动生成key也可能出现异常。你可以执行db.<你的集合名称>.properties()命令查看集合配置，确认keyOptions.type为traditional/autoincrement等合法类型，没有配置不符合规则的key前缀、后缀。
• 验证图创建逻辑的参数正确性：如果是通过代码、AQL命令创建图，检查传入的边定义、顶点集合名称是否有拼写错误、多余符号，避免系统误将无效内容拼接入文档ID。你可以先通过Web UI可视化界面创建最简测试图（仅1个顶点集合、1个边集合，无额外自定义配置），确认基础流程是否正常。
• 版本兼容性排查：3.7.x及更早的部分ArangoDB小版本存在自动生成key的偶发校验bug，如果上述排查都未发现问题，升级到最新稳定版即可解决。

内容的提问来源于stack exchange，提问作者Volatil3